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1.  Scope 

This  Software  Design  Document  (SDD)  establishes  the  design  for  the  Computer  Software 
Configuration  Item  (CSCI)  identified  as  the  Radio  Perfomance  Monitor  (Radmon)  of  the 
Simulation  Network  (SIMNET)  system. 

This  SDD  specifies  the  preliminary  design  for  the  Radmon  CSCI.  This  includes  descriptions 
of  external  interfaces  and  Computer  Software  Component  (CSC)  decomposition. 

Section  2.,  Referenced  Documents,  lists  documents  referenced  in  this  SDD. 

Section  3.,  CSCI  Design,  provides  an  overview  of  this  CSCI:  its  role,  interfaces  with  the  rest 
of  the  SIMNET  system,  and  its  internal  orgaiuzation.  We  also  describe  the  individual  CSCs 
that  comprise  this  CSCI  in  terms  of  execution  control  and  data  flow,  internal  interfaces,  and 
relationships  among  CSCs. 

This  CSCI  was  developed  according  to  the  following  software  standards:  X-Window  System, 
version  11,  (MIT  1987),  and  OSF/Motif  (Open  Software  Foundation). 
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2 .  REFERENCED  DOCUMENTS 

The  following  documents  are  referenced  by  this  Software  Design  Document 


2.1  Government  Documents 

None 


2.2  Non-Government  Documents 

2.2.1  Specifications 
None 

2.2.2  Standards 


None 


2.2.3  Drawings 

None 


2.2.4  Other  Publications 

SIMNET  CVCC  Analysis  <rf  Simulated  SINCGARS  Communications  in  the  SIMNET  CVCC  Company-Level 
Experiments:  Ft.  Knox  Close  Combat  Testbed,  January-May,  1990,  BBN  Report  No.  7690  (May  1991). 

SIMNET  CVCC  Simulation  of  the  SINCGARS  Radio  System  Software  Design  Document ,  BBN  Report  No. 
7632  (July  1991). 

SIMNET  Simulation  Radio  Communication:  A  Testbed  for  Investigating  Combat  Vehicle  C^I  Technology, 
BBN  RqxMt  No.  7352  July  1990);  (includes  Appendix  C:  Radio  Performance  Monitor). 
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3.  CSCI  Design 
3.1  CSCI  Overview 

The  Radio  Performance  Monitor  (Radmon)  CSCI  is  used  to  monitor  and  analyze  the 
performance  of  the  SINCGARS  radio  simulation  for  SIMNET.  Radmon  monitors  traffic 
on  the  simulation  network  and  records  information  broadcast  by  the  SINCGARS  radio 
simulator  hosts  concerning  every  important  state  change  of  every  simulated  radio.  Radmon 
maintains  a  running  history  of  all  state  changes  for  each  radio. 

The  information  that  Radmon  records  can  be  saved  in  a  file  and  subsequently  restored  from 
that  file.  Radmon  allows  the  user  to  browse  through  recorded  data  to  examine  interactions 
in  detail.  The  recorded  data  can  also  be  summarized  to  show  channel  utilization,  radio 
utilization,  and  other  statistics  of  radio  activity. 

The  collected  information  can  be  presented  in  several  ways: 

•  A  stripchart  display  shows  the  activity  of  radios  as  a  function  of  time. 

•  A  connectivity  map  shows  the  communication  paths  that  are  usable. 

•  A  status  display  shows  the  detailed  state  of  individual  radios. 

The  Radmon  CSCI  interfaces  externally  to  the  SINCGARS  radio  simulation  hosts.  These 
simulation  hosts  monitor  the  position  of  various  knobs  and  buttons  on  simulated  radios  and 
broadcasts  "transmitter  PDUs"  reflecting  the  state  information  about  each  radio.  They  also 
monitor  "vehicle  appearance  PDUs"  broadcast  by  vehicle  simulators  to  determine  the 
position  of  the  vehicles  and  hence  the  radios  in  those  vehicles.  The  radio  simulation  host 
broadcasts  a  "receiver  PDU"  each  time  the  signal  a  radio  is  receiving  changes.  The 
Radmon  CSCI  records  information  broadcast  by  the  radio  simulator  hosts. 

Radmon  is  an  X- windows  application  using  the  Afon/ toolkit.  The  content  and  layout  of 
the  user  interface  is  specified  using  Motif  UIL  (User  Interface  Language).  An  X- windows 
resource  file  specifies  details  of  the  interface  such  as  button  labels.  In  addition  to  X- 
windows  events,  Radmon  uses  the  UNIX  alarm  clock  signal  to  periodically  wake  up  and 
process  PDUs  received  from  the  simulation  network. 
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3.1.1  CSCI  Architecture 

Radmon  functionality  can  be  broken  down  into  four  top-level  CSCs,  shown  in  Figure  3-1: 

•  Top-Level  Radio  Monitor  Software 

•  Data  Acquisition 

•  Graphical  User  Interface  (GUI) 

•  Utilities 


Figure  3-1.  Radmon  CSCI  Structure 


The  Top  Level  Radmon  Software  CSC  provides  the  program  entry  point,  and  the  main 
simulation  loop  is  found  here.  This  CSC  initializes  tune  and  state  routines  and  the  network 
interface;  it  also  invokes  routines  to  select  the  mode,  and  timer  routines  to  update  the  map 
display  and  generate  vehicle  and  radio  names.  It  consists  of  two  second-level  CSCs: 
Radmon  and  Display. 

The  Data  Acquisition  (DA)  CSC  captures  the  exchange  of  data  between  radio  sitriulation 
hosts.  It  records  this  exchange  as  a  time-stamped  sequence  of  events,  which  in  turn  serves 
as  raw  data  for  the  Graphical  User  Interface  CSC.  The  data  can  be  used  in  real  time  or 
stored  in  a  file  and  retrieved  later. 

The  GUI  CSC  sorts  out  the  raw  data  from  the  DA  CSC  and  puts  it  into  a  format  that  can  be 
used  by  the  operator  to  display  connectivity,  specific  parameters  for  specific  radios, 
operating  status  of  radios,  and  the  activity  of  i^os  as  a  function  of  time. 

The  Utilities  CSC  provides  routines  used  by  the  other  CSCs.  These  include  hash  table 
routines,  routines  for  manipulating  time  lines,  and  routines  to  keep  track  of  tunings. 
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3.1.2  System  States  and  Modes 

At  the  top  level,  the  Radmon  CSCI  operates  in  two  modes:  on-line  and  off-line.  In  on-line 
mode,  data  acquisition  occurs  and  live  data  is  displayed.  In  off-line  mode,  there  is  no  real¬ 
time  data  acquisition;  instead,  data  obtained  from  stored  files  is  displayed. 


3.1.3  Memory  and  Processing  Time  Allocation 

Memory  and  processing  time  are  allocated  to  the  Data  Acquisition  CSC  as  needed. 
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3.2  CSCI  Design  Description 
3.2.1  Top-Level  Radmon  Software  CSC 

The  Top  Level  Radmon  Software  CSC  provides  the  program  entry  point,  and  the  main 
simulation  loop  is  found  here.  This  CSC  initializes  tune  and  state  routines  and  the  network 
interface;  it  also  invokes  routines  to  select  the  mode,  and  timer  routines  to  update  the  map 
display  and  generate  vehicle  and  radio  names.  It  consists  of  two  second-level  CSCs;  radmon 
and  display,  as  illustrated  in  Figure  3.2.1-1. 


Figure  3.2.1-1.  Top-Level  Radmon  Software  CSC 
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3.2. 1.1  Radmon  CSC 

The  Radmon  CSC  provides  the  program  entry  point,  and  the  main  simulation  loop  is  found 
here.  This  CSC  initializes  tune  and  state  routines  and  the  network  interface;  it  also  invokes 
routines  to  select  the  mode,  update  the  map  display,  generate  vehicle  and  radio  names.  The 
Radmon  CSC  is  comprised  of  the  CSUs  shown  in  Figure  3.2.1. 1-1. 


Radmon 

CSC 


Initialization 

Timer 

Mode 

Miscellaneous  (TBD) 


Figure  3.2.1.1>1.  Top  Level  Software — Radmon  CSC  Structure 


Initialization  CSV 

The  Initialization  CSU  consists  of  routines  that  initialize  the  Radmon  CSC. 


main 

main  provides  the  program  entry  point  for  the  CSCI,  and  the  main  loop  is  executed  here.  It 
announces  the  program  name,  sets  up  the  system  to  catch  normal  termination  signals, 
processes  command  and  line  arguments,  debugs  the  system  as  necessary,  and  initializes  the 
display,  tune  and  state  routines,  and  the  network  inteiface.  Its  call  is  int  main  (argc,  argv). 


1  Parameters  1 

Parameter 

Tvoe 

Where  Tvpedef  Declared 

amc 

int 

See  AoDendix. 

aruv 

DOinter  to  char 

See  Aooendix. 

1  Return  values  1 

Return  Value 

0 

1  int  1 

1  - 
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Function 


htReplenish 


htFreelnit 


InitSimNetwork 


netReplenish 


resetTime 


Online 


int  banner 


stateReplenishFreeList 


state  inrt 


tlReplenishPreeList 


tuneReplenishFreeList 


tune  init 


Calls 


Where  Described 


displav.c 


hTable.c 


hTable.c 


net.c 


net.c 


radmon.c 


radmon.c 


radmon.c 


radmon.c 


state  .c 


timeline.c 


tune.c 


tune.c 


InitVehicle 

InitVehicle  initializes  a  vehicle  table  entry.  It  is  called  as  net_vehicles  grows  to  initialize  new 
entries.  The  function  call  is  void  InitVehicle(vp,  vidx). 


set_identification_label 

sct_identification_label  sets  the  identification  label  widget  to  identify  the  data  currently  being 
presented.  This  may  be  data  from  a  file  or  it  may  be  on-line  currently  being  acquired  from  the 
simuladon  network.  The  function  call  is  void  set_identification_label(). 


1  Calls  1 

1  Function 

Where  Described 

status.c 
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DestroyEverything 

DestroyEverything  calls  all  the  destroy  routines  to  release  all  the  resources  associated  with  the 
current  data.  The  function  call  is  void  DestroyEverything(), 


Ca 

IIS 

Function 

Where  Described 

DestroyVehiclesO 

radmon.c 

state.c 

traffic.c 

tune.c 

1  display  deselectO  1 

display  .c 

net.c  1 

DestroyWidget 

DestroyWidget  destroys  a  widget,  insuring  that  the  widget  exists  and  that  the  point  is  nullified 
afterward,  'file  function  call  is  void  DestroyWidget(wp). 


1  Parameters  1 

Parameter 

Tvoe 

Where  Tvpedef  Declared 

wp 

pointer  to  Widoet 

See  Appendix. 

DestroyVehicIes 

Destroy  Vehicles  reinitializes  the  net_vehicles  to  its  initial  state,  and  resources  are  released.  'The 
function  call  is  void  DestroyVehiclesO- 


1  Calls  1 

Function 

Where  Described 

DestroyWIdoetO 

radmon.c 

tlFreetrp) 

timeline.c 

I 
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resetRadios  p 

resetRadios  discards  state  information  for  all  radios.  The  radios  are  otherwise  retained.  The 

function  call  is  void  resetRadios().  ^ 


Cal 

Is 

Function 

Where  Described 

net.c 

1  tlFree(ml 

timeline.c 

vehicle_name 

vehicle_name  ^nerates  a  vehicle  nanM.  A  vehicle  is  named  <battalionxcompanyxbumper> 
if  that  information  is  known;  otherwise,  it  is  nan^  with  its  vehicle  ID.  The  function  call  is 
char  *vehicle_name(vp). 


1  Return  Values  I 

Return  Value 

Type 

Meanina 

but 

char 

Vehicle  name 

radio_name 

radio.naroe  generates  the  name  of  a  radio.  A  radio  is  named  cvehicle  name>/[AiB]  depending 
on  whether  this  is  the  first  or  second  radio  in  the  vehicle.  The  function  call  is  char 
*radio_name(ip). 
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state_radio_name 

state.radio.name  generates  the  name  of  the  radio  which  is  transmitting  in  a  particular  state. 
The  function  call  is  char  *state_radio_name(st). 


print_banner 

print.banner  prints  the  banner : 

SINCGARS  RadioMonitor 
%s 

BBN  Systems  and  Technologies  Corporation 
Cambridge,  MA,  02138 

The  function  call  is  void  print_bannerO. 


Timer  CSV 

The  Timer  CSU  consists  of  routines  that  update  displays  and  control  processing  intervals. 
sIow_periodic 

slow_periodic  is  a  timer  routine  to  update  things  such  as  the  various  displays  about  every 
second  It  also  replenishes  resources  used  by  AST  level  code.  The  function  call  is  void 
slow_periodic(). 
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Calls 


Function 


htReolenish 


map_advance_display{up_to,  max_advance, 
if  frozen) 


netReplenish 


EnabiePeriodic 


TimeoutRadios 


Timeoutvehicles 


stateReplenishFreeList 


state  update 


tIReplenishFreeList 


ateRadkjTraffic 


tuneReplenishFreeList 


Where  Described 


hTable.c 


map.c 


net.c 


radmon.c 


radmon.c 


radmon.c 


state. c 


state.c 


timeline.c 


traffic.c 


tune.c 


inedium_periodic 

medium_periodic  is  a  timer  routine  called  every  1/4  second  to  advance  the  map  display.  The 
function  call  is  void  medium_periodic(). 


EnabiePeriodic 

EnabiePeriodic  turns  the  fast  periodic  processing  back  on.  The  function  call  is  void 
EnablePeriodicQ. 


DisablePeriodic 

DisablePeriodic  turns  the  fast  periodic  processing  off.  The  function  call  is  void 
DisablePeriodicC). 


fast_periodic 

fast_periodic  is  invoked  frequently  via  an  alann  clock  signal  to  process  incoming  PDUs.  The 
function  call  is  void  fast_periodicO. 


1  Calls  1 

Function 

Where  Described 

ReadPDUsO 

net.c 

EnablePeriodicO 

radmon.c 
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resetTime 

resetlline  resets  the  simulation  clock  time  to  zero.  The  function  call  is  resetTime(). 


Mode  CSV 
Offline 

Offline  performs  various  actions  to  switch  the  monitor  from  online  mode  to  offline  mode.  The 
function  call  is  void  OfflineQ. 


1  Calls  1 

Function 

Where  Described  I 

mao  resetO 

set  identification  labelO 

radnxjn.c 

traffic  resetO 

traffic.c 

Online 

Online  performs  various  actions  to  switch  the  monitor  from  offline  mode  to  online  mode.  The 
function  call  is  void  Online(). 


1  Calls  1 

Function 

1  Where  Described 

map  resetO 

netaeteaddrO 

net.c 

set  identification  labelO 

radmon.c 

Miscellaneous— CSV  category  to  be  determined 
TimeoutRadios 

HmeoutRadios  marks  radios  for  which  no  transmitter  PDU  has  been  received  for  12  seconds 
as  non-existent  The  function  call  is  void  TimeoutRadiosO- 


1  Calls  1 

1  Function 

Where  Described 

net.c 
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TimeoutVehicles 

TimeoutVehicles  marks  vehicles  for  which  no  appearance  PDU  has  been  received  for  12 
seconds  as  non-existent  The  function  call  is  void  TimeoutVehicles(). 


1  Calls  1 

Function 

Where  Described 

map  vehicle  vanished(vpl) 

map.c 

exit_gracefully 

exit_grace£ully  cleans  up  the  screen  before  exiting.  The  function  call  is  void  exit_gracefully(). 


3.2. 1.2  Display  CSC 

The  Display  CSC  contains  routines  related  to  the  top-level  display  widgets.  It  is  comprised  of 
three  CSUs,  shown  in  Figure  3.2. 1.2-1. 


Display 

CSC 


Initialization 
Callback 
User  Interface 


Figure  3.2.1.2>1.  Top  Level  Software — Display  CSC  Structure 
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Initialization  CSU 
function  descend 


function_descend  descends  through  selected  buttons  of  the  button  list  tree  applying  fn  to  the 
button  lists.  The  function  call  is  void  function_descend(fbc,  fh). 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

fbc 

FUNCTION  BUTTON 
CLOSUREP 

See  Appendix. 

*fn 

void 

See  Appendix. 

create_function_itenis 

create_function_items  constructs  a  resource  list  and  retrieves  the  label  strings  to  be  put  on  the 
buttons.  It  then  constructs  the  item  lists  for  the  button  lists  and  recursively  does  the  same  for 
sub-function  button  lists.  The  function  call  is  void  create_function_items(w,  fbc). 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

w 

Widaet 

See  Appendix. 

fbc 

FUNCTION  BUTTON  CLOSU 
REP 

See  Appendix. 

NameToWidget 

NameToWidget  gets  a  widget  id  for  the  named  child  of  a  widget.  It  checks  for  failure  and 
aborts.  The  Action  call  is  Widget  NameToWidgetfparent,  name). 
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I 

CvtStringToWidget  | 

CvtStringToWidget  is  a  lesouice  converter  from  string  to  widget,  where  the  string  is  the  name 

of  the  widget  relative  to  the  parent  The  function  call  is  void  CvtStringToWidget  (args,  nargs,  — 

firomVal,  toVal).  ■ 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

args 

XrmValueRr 

See  Appendix. 

pointer  to  int 

See  Appendix. 

fromVal 

XrmValueRr 

toVal 

XrmValueRr 

Function  I  Where  Described 

NameTo Widget  I  displav.c 


CvtStringToStringLtoR 

CvtStringToStrin^toR  converts  a  string  to  a  compound  converting  \n  to  separators,  'fhe 
function  call  is  void  CvtStringToXmStringLtoR  (args,  nargs,  fromVal,  toVal). 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

args 

XrmValueRr 

See  Appendix. 

pointer  to  int 

See  Appendix. 

fromVal 

XrmValueRr 

See  Appendix. 

toVal 

XrmValueRr 

See  Appendix. 

CvtStringT  oColor 

OtStringToColor  converts  a  string  to  an  XColor.  The  function  call  is  void  CvtStringToColor 
(args,  nargs,  fromVal,  toVal). 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

args 

XrmValueRr 

See  Appendix. 

naros 

pointer  to  int 

See  Appendix. 

fromV^ 

XrmVahiePtr 

See  Appendix. 

toVal 

XrmValuePtr 

See  Appendix. 
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display_init 

display_init  initializes  lots  of  display  stuff  and  creates  most  of  the  widget  tree.  The  function  call 
is  void  display_init(argcp,  argv). 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

arocp 

pointer  to  int 

See  Appendix. 

array  of  pointer  to  char 

See  Appendix. 

1  Calls  1 

Function 

Where  Described 

create  function  itemsfw,  fbc) 

displav.c 

NameToWidaetfoarent.  name) 

displav.c 

fileReaisterNamesO 

file.c 

filelnitWidaetsO 

file.c 

mapReoisterNamesO 

map.c 

mapInitWidoetsO 

map.c 

stateReoisterNamesf) 

state.c 

state  InitWidoetsO 

state.c 

trafficReoisterNamesO 

traffic.c 

trafficinitWidaetsO 

traffic. c 

Callback  CSV 

The  Callback  CSU  consists  of  functions  that  activate  callbacks  for  various  buttons. 


quit_callback 

quit.callback  activates  the  callback  for  the  quit  button  and  exits  the  program.  The  function  call 
is  void  quit_callback(w). 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

w 

Widaet 

See  Appendix. 

1  Calls  1 

Function 

Where  Described 

exit  aracefullv 

radmon.c 
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dump_callback 

dunq)_callback  activates  the  callback  for  the  dump  button  and  dumps  the  widget  tree  to  stdout 
for  debugging.  The  function  call  is  void  dump_c^back(w). 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

w 

Widaet 

See  Appendix. 

1  Calls  1 

Function 

Where  Described 

EnablePeriodicO 

radmon.c 

Disable  PeriodicO 

radmon.c 

reset_canback 

reset.callback  activates  the  callback  for  the  reset  button.  It  returns  to  online  mode  if  necessary 
and  deletes  all  recorded  data.  The  function  call  is  void  reset_callback(w). 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

w 

Widqet 

See  Appendix. 

1  Calls  1 

Function 

Where  Described 

mao  reset!) 

mao.c 

DrainPDUsO 

net.c 

EnablePeriodicO 

radmon.c 

DisablePeriodicO 

radmon.c 

resetTimeO 

radmon.c 

DestrovEvervthinoO 

radmon.c 

Online!) 

radmon.c 

resetRadios!) 

radmon.c 

traffic  reset!) 

traffic. 

I 

I 

I 
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function_callback 

function_callback  activates  the  callback  for  the  function  button  list  If  the  selected  function  has 
sub-functions,  the  current  sub-function  widgets  are  unmanaged.  The  sub-function  widget  is 
activated  and  any  previously  active  sub-sub-function  widgets  are  reactivated.  Then  the 
function  attached  to  the  button  is  executed.  The  function  call  is  void  function_callback(w,  fbc, 
cback). 
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User  Interface  CSV 

The  User  Interface  CSU  consists  of  routines  that  control  the  user  interface. 


display_deselect 

display_deselect  deselects  the  selected  button,  if  any.  The  function  call  is  void 
display_deselectO. 


clipResize 

clipResue  resizes  the  callback  ftv  the  clipping  widget  of  the  general_axea_widget  It  attempts 
to  make  the  withh  of  the  Pack  widget  track  the  clipping  widget  There  are  scenarios  in  which 
this  can  fail.  It'snotclearif  these  failures  can  be  craiected  given  the  way  the  X  toolkit 
behaves.  The  function  call  is  void  clipResize(w,  data,  cback). 


1  Parameters  1 

Parameter 

Type 

Where  Tvoedef  Declared 

w 

Widaet 

See  Aooendix. 

data 

caddr  t 

See  Anoendix. 

cback 

XmAnvCalRsackStnjct 

See  Aooendix. 

Dispatch 

Dispatch  disposes  of  all  X  events.  The  function  call  is  void  DispatchQ. 


3.2.2  Data  Acquisition  CSC 

This  CSC  monitors  transmitter  and  receiver  PDUs  broadcast  by  the  radio  simulation  hosts  and 
the  vehicle  appearance  PDUs  broadcast  by  vehicle  and  radio  simulation  hosts.  As  each  PDU  is 
received,  the  state  of  die  affected  radio  or  radios  is  changed.  A  radio's  state  includes  the 
following  infcnrmation: 

•  Tuning 

•  Status  (non-existent,  inactive,  inoperative,  receiving,  not-receiving,  transmitting) 

•  Speaker  (if  status  equals  transmitting) 

•  Antenna  hei^t 

•  Received  power  (if  receiving  or  not-receiving) 
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•  Who  is  transmitting  (if  receiving  or  not-receiving) 

•  Geographic  position 

The  new  state  is  found  in  or  entered  into  a  hash  table  and  the  pointer  to  that  hash  table  entry, 
along  with  the  time  at  which  the  PDU  was  received,  is  appended  to  the  timeline  for  that  radio. 
A  separate  timeline  is  maintained  for  each  radio.  As  new  radios  appear  on  the  netwOTk,  new 
timelines  are  created.  All  timelines  are  maintained  in  main  memory.  The  timelines  comprise 
the  raw  data  from  which  radmon  generates  various  displays. 

The  Data  Acquisition  consists  of  two  CSUs — ^File  and  Net — as  shown  in  Figure  3.2.2- 1. 


Data  Acquisition 
CSC 


File 

Net 


Figure  3.2.2-1.  Data  Acquisition  CSC  Structure 

3.2. 2.1  File  CSU 

The  File  CSU  consists  of  routines  for  reading  and  writing  files. 


file_ok 

file_ok  is  the  file  selection  callback.  It  applies  file_io_function  to  the  selected  file  name.  The 
function  call  is  void  file_ok(w,  data,  cback). 


1  Parameters  I 

Parameter 

Tvoe 

Where  Tvoedef  Declared 

w 

Widaet 

See  Appendix. 

data 

caddr  t 

See  Appendix. 

cback 

pointer  to 

XMSelectionBoxCallbackStruct 

See  Appendix. 
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file^popup 

file_popup  pops  up  a  widget  on  top  of  other  widgets.  The  function  call  is  void  file_popup(w). 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

w 

Widget 

See  Appendix. 

fiIe_error 

file_enor  pops  up  an  error  message  for  a  file  io  operation.  The  function  call  is  void 
file_error(fnit,  arg). 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

fmt 

pointer  to  char 

See  Appendix. 

ara 

pointer  to  char 

See  Appendix. 

Ca 

Is 

Function 

Where  Described 

file  popup 

file.c 

file_flush 

file_fiush  brings  the  display  up  to  date  before  continuing  with  the  file  operation.  The  function 
call  is  void  file_flush(). 


file_inform 

file.infoim  pops  up  the  file  progress  widget  containing  the  specified  message  and  initializes  the 
scale  widget.  The  function  call  is  void  ^ejnformftet,  arg,  maximum). 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

fmt 

pointer  to  char 

See  Appendix. 

arg 

pointer  to  char 

See  Appendix. 

maximum 

int 

See  Appendix. 
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1  Calls  1 

Function 

Where  Described 

file  flush 

file.c 

file  popup 

file.c 

fil  e_i  nfo  rin_en  d 

file_inform_end  pops  down  the  file_mfonn_widget.  The  function  call  is  void 
file_inform_end(). 


file_gets 

fUe_gets  does  fgets  on  the  input  file  and  count  lines  and  updates  the  file_infonn_widget  as 
reading  progresses.  The  function  call  is  char  ♦file_gets(buf,  size,  f). 


1  Parameters  1 

Parameter 

Tvoe 

Where  Tvpedef  Declared 

buf 

pointer  to  char 

See  Appendix. 

size 

int 

See  Appendix. 

f 

pointer  to  FILE 

See  Appendix. 

1  Return  Values  I 

Return  Value 

NULL 

char 

buf 

char 

Cans 

Function  I  Where  Described 

function  I 


file_count 

file.count  increments  the  lines  which  have  been  written  to  the  output  file  and  updates  the 
file_infonn_widget  to  indicate  progress.  The  function  call  is  void  file_count(n). 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

n 

int 

See  Appendix. 

I 

I 
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file_write_file 

file_write_file  is  a  file_io_functioii  to  write  a  radmon  file.  The  selected  file  name  is  massaged 
to  add  a  j^dmon  extension  if  necessary,  the  file  is  opened  and  the  various  parts  of  the  file 
written.  The  function  call  is  void  file_write_file(filename). 


1  Parameters  1 

Parameter 

Type 

Where  Tvpedef  Declared 

filename 

pointer  to  char 

See  Appendix. 

Ca 

Is 

Function 

Where  Described 

file  errorffmt.  ara) 

file.c 

file  infoimffmt,  ara,  maximum) 

file.c 

file  inform  endO 

file.c 

file  countO 

file.c 

net.c 

net.c 

OisablePeriodicO 

radnxjn.c 

state  count  fileO 

state.c 

state.c 

tune  count  fileO 

tune.c 

tune  write  file(f) 

tune.c 

file_write 

file_write  activates  the  callback  for  the  "write"  button.  It  pops  up  a  file  selection  widget  to 
select  a  filename,  and  the  file_io_function  is  set  to  file_write_file.  The  function  call  is  void 


file_write(). 

Calls 

Function 

{Where  Described 

1  file.c 

file__read_file 

file_rcad_file  is  a  file_io_function  to  read  a  radmon  file.  The  selected  file  is  opened  and  the 
various  parts  of  the  file  read.  A  failure  deletes  all  the  information  read  and  operation  reverts  to 
on-line  mode.  The  function  call  is  void  file_read_file(filename). 
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I  filename  I  pointer  to  char  I  See  Appendix. 


Ca 

Is 

Function 

Where  Described 

file  errorffmt,  am) 

file.c 

file  infoirnffnit,  arn.  maximum) 

file.c 

file  inform  endO 

file.c 

file  qetsfbuf,  size,  f) 

file.c 

net  read  file(f,  version) 

net.c 

DrainPDUsO 

net.c 

DisablePeriodicO 

radmon.c 

DestrovEvervthinqO 

radmon.c 

OfflineO 

radmon.c 

Online!) 

radmon.c 

state  read  fileff,  version) 

state. c 

tune  read  fileff,  version) 

tune.c 

fi!e_read 

file_rcad  activates  the  callback  for  the  "read”  button.  It  pops  up  a  file  selection  widget  to  select 
a  filename,  and  the  file_io_function  is  set  to  file_iead_file.  The  function  call  is  void 
file_readO. 


1  Calls  1 

Function 

Where  Described 

file  DODUD(w) 

file.c 

filelnitWidgets 

filelnitWidgets  gets  widget  IDs  for  file  widgets.  The  function  call  is  void  fileInitWidgets(). 


1  Calls  1 

Function 

Where  Described 

NameToWkJqetfoarent,  name) 

display.c 

3.2. 1.2  Net  CSU 

The  Net  CSU  contains  routines  that  manage  the  interface  between  the  radio  monitor  and  the 
simulation  Ethernet 
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InitSimNetwork 

InitSimNetwotk  initializes  processing  of  Ethernet  conamunications.  It  opens  and  initializes  the 
network  interface,  obtains  Ae  network  address,  and  subscribes  to  the  simulation,  data 
collection,  and  radio  protocols  for  the  current  exercise.  The  function  call  is  void 
InitSimNetworkO. 


Calls 

Function  I  Where  Described 

htlnit(size.  key)  I  hTabte.c  ~ 


net_destroy 

net.destroy  releases  net  resources  and  reset  to  ground  state.  The  function  call  is  void 
nct_destroy(). 


Function 


httnitlsize.  ke 


htFreelht 


Calls 


Where  Described 


hTable.c 


hTable.c 


VehiclelDtoIndex 

VehiclelDtoIndex  converts  a  vehicle  ID  into  the  net_vehicles  index.  It  looks  up  the  vehicle  id  in 
the  vehicle  id  hash  table  and  returns  the  value  found  there,  if  any.  If  the  vehicle  is  not  found, 
an  element  of  net.vehicles  is  allocated  and  entered  into  the  hash  table.  The  function  call  is  int 
VehicleIDtoIndex(vehicleID). 


Parameters 


Parameter 


vehiclelD 


VehiclelO 


Where  Tvoedef  Declared 


See  Appendix. 


Return  Values 


Return  Value 


-1 


vidx 


Meanin 


No  entries  availabie 


Vehicie  id  from  vehicle  id  hash 
table 
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1  Calls  1 

Function 

Where  Described 

htlnsert(ht.  name,  value) 

hTable.c 

htRnddit,  name,  value) 

hTable.c 

net_read_file 

net_read_file  reads  the  net  data  from  a  radmon  file.  The  net  data  consists  of  the  vehicle 
descriptions  and  the  radio  descriptions.  The  function  call  is  char  *net_read_file(f,  version). 


1  Parameters  1 

Parameter 

Type 

Where  Tvoedef  Declared 

f 

DOinter  to  FILE 

See  Aooendix. 

version 

int 

See  Aooendix. 

1  Return  Values  1 

Return  Value 

“Premature  EOF  while  reading 
%s" 

char 

"File  %8  has  bad  formar 

char 

“Bad  vehicle  ID  in  %s" 

char 

“Bad  radio  ID  in  %s” 

char 

err 

NULL 

Ca 

Us 

Function 

Where  Described 

file  oetsfbuf.  size,  f) 

file.c 

mao  vehicle  aooearedfvoi) 

mao  init  radiofro) 

Vehiclel  Dtolndexfvehiclel  0) 

net.c 

netReolenishO 

net.c 

timeline.c 

I 

net_count_file 

I  net_couni_file  predicts  how  many  lines  of  output  will  be  generated  when  writing  the  net 

information  portion  of  a  radmon  file.  The  fruiction  call  is  int  net_count_file(f). 

I 

I 
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net_wnte  file 

netjwrite_f!lc  writes  the  net  portion  of  a  radmon  file.  The  function  call  is  void 
net_write_file(f). 


netReplenish 

netReplenish  replenishes  resources  to  be  consumed  at  "interrupt"  level.  Interrupt  routines  are 
not  pomitted  to  malloc  memory,  so  we  preallocate  memory  h^.  The  function  call  is  void 
netReplenishO. 


Calls 

Function  "whers  Described 

InitVehiclelvD.  vidxl _ radmon.c _ 
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ReadPDUs 

ReadPDUs  reads  and  processes  PDUs  received  from  the  simulation  network.  The  function  call 
is  void  ReadPDUsO. 


Ca 

Is 

Function 

Where  Described 

ProcessVehicleAppearancePOU(pdu, 

timestamD) 

net.c 

ProcessDeactivatePOU(pdu,  timestamp) 

net.c 

ProcessStatusChanaePDLKpdu.  timestamp) 

net.c 

ProcessVehicleStatusPDLKpdu.  timestamp) 

net.c 

ProcessTransmitterPDUtpdu,  timestamp) 

net.c 

ProcessReceiver  PDUtpdu,  timestamp) 

net.c 

DrainPDUs 

DrainPDUs  reads  and  discards  all  pending  PDUs  and  eliminates  old  PDUs.  The  function  call 
is  void  DrainPDUsO. 


netChangeState 

netChangeState  records  a  new  state  for  a  radio.  The  first  time  a  radio  is  mentioned,  its  initial 
state  is  created  and  its  position  in  the  net.radios  vector  is  established.  The  function  call  is  void 
netChangeState(rp,  st,  timestamp). 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

ro 

RadioInfoP 

See  Appendix. 

St 

STATEP 

See  Appendix. 

timestamp 

MSEC 

See  Appendix. 

1  Calls  1 

1  Function 

i  Where  Described  1 

1  state  find(st) 

state.c 

timellne.c 
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ProcessVehicleAppearancePDU 

Process VehicleAppearancePDU  mailcs  a  vehicle  as  existing.  The  first  time  a  vehicle  is  seen,  its 
position  in  the  net_vehicles  vector  is  established.  The  function  call  is  void 
ProcessVehicleAppearancePDUfpdu,  timestamp). 


Parameter 


pdu 


timestam 


Parameters 


Where  Typedef  Declared 


pointer  to  Vehicle  Appearance  See  Appendix. 
Variant 


MSEC  See  ADoendix. 


Function 


map  vehicle  aoDearedivDl 


VehiclelDtoIndexivehiclelO 


netChanoeState 


anjEMBumsuigi 


Calls 


Where  Described 


c 


net.c 


net.c 


ProcessDeactivatePDU 

The  function  call  is  void  ProcessDeactivatePDUCpdu,  timestamp). 


Parameter 


pdu 


timestam 


Parameters 


Where  Typedef  Declared 


pointer  to  Vehicle  Appearance  See  Appendix. 
Variant 


MSEC  See  AoDendix. 


Function 


VehiclelDtoIndexIvehiclelD 


Calls 


Where  Described 


net.c 


ProcessStatusChangePDU 

The  function  call  is  void  ProcessStatusChangePDUfpdu,  timestamp). 


Parameter 


pdu 


timestam 


Parameters 


Where  Typedef  Declared 


pointer  to  Vehicle  Appearance  See  Appendix. 
Variant 


MSEC  I  See  ADoendix. 
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Function 


VehiclelOtolndex(vehiclelD 


netChanaeState 


Calls 


Where  Described 


net.c 


ujgEisjjrauigi 


ProcessVehicIeStatusPDU 

The  function  call  is  void  Pnx:essVehicleStatusPDU(pdu,  timestamp). 


Parameter 


pdu 


timestam 


Parameters 


e  Where  Tvoedef  Declared 


pointer  to  Vehicle  Appearance  See  Appendix. 
Variant 


MSEC  See  Apoendix. 


Function 


Vehiclel  Dtolndextvehiclel  D 


netChanaeState 


Calls 


Where  Described 


net.c 


net.c 


ProcessTransmitterPDU 

ProcessTransmitterPDU  updates  what  is  known  about  a  transmitter  from  a  Transmitter  PDU 
describing  it.  The  funcdon  call  is  void  ProcessTransmitterPDU(pdu,  timestamp). 
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ProcessReceiverPDU 

ProcessReceiverPDU  updates  what  is  known  about  a  receiver  from  a  Receiver  PDU  describing 
it  The  function  call  is  void  ProcessReceiverPDU(pdu,  timestamp). 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

pdu 

pointer  to  Vehicle  Appearance 
Variant 

See  Appendix. 

timestamp 

MSEC 

See  Appendix. 

1  Calls  1 

Function 

Where  Described 

Vehiclel  Dtoindexivehiclel  D) 

net.c 

net.c 

net_geteaddr 

net_geteaddr  gets  a  string  for  our  net  address.  The  function  call  is  char  *net_geteaddr(). 


1  Return  Values  1 

Return  Value 

Type 

Meanina 

print  eaddr 

char 

Prints  network  address. 

3.2.3  Graphical  User  Interface  CSC 

This  CSC  processes  the  messages  captured  by  the  Data  Acquisition  CSC  and  provides  a  means 
for  displaying  information  about  them.  It  consists  of  four  second-level  CSCs:  the 
Connectivity  Display  CSC,  Status  Summary  CSC,  Strip  Chart  CSC,  and  Statistics  Summary 
CSC,  as  shown  in  Figure  3.2.3- 1. 
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Figure  3.2.3>1.  Graphical  User  Interface  CSC  Structure 


3.2.3. 1  Connectivity  Display  CSC 

The  Connectivity  Display  CSC  provides  map  display  functions  and  allows  the  user  to  see 
vehicles  with  radios  and  their  connectivity.  Vehicles  are  represented  by  rectangles  and  have 
radio  rectangles  attached  to  either  end;  the  coIot  of  the  radio  rectangle  denotes  whether  it  is 
receiving,  not  receiving,  transmitting,  or  doing  nothing.  Connectivity  between  pairs  of  radios 
is  represented  by  lightning  bolts  between  them;  the  shape  and  color  of  the  bolts  represent  the 
state  of  connectivity.  The  display  is  updated  as  radios  change  states.  It  can  be  fit>zen  and 
stepped  from  one  state  change  to  the  next,  or  stepped  to  the  next  anomalous  state. 

The  Connectivity  Display  CSC  is  comprised  of  the  CSUs  shown  in  Figure  3.2.3  2. 


Connectivity 
Display  CSC 


Initialization 

Drawing 

Map  Advancement 

Selection 

Map  Time 

Map  Display/Layout 


Figure  3.2.3>2.  GUI — Connectivity  Display  CSC  Structure 


Initialization  CSV 

The  Initialization  CSU  contains  code  for  initializing  various  elements  of  the  Connectivity 
Display  such  as  color  and  map  styles. 


ForegroundColorDefault 

ForegroundColorDefault  is  an  externally  defined  routine  that  returns  an  XColor.  The  call  is 
void  ForegroundColorDefault  (widget,  offset,  valPtr). 


1  Parameters  1 

Parameter 

Tvoe 

Where  Tvoedef  Declared 

widoet 

Widoet 

See  Appendix. 

offset 

int 

See  Appendix. 

vaIRr 

XRMVaiuePtr 

See  Appendix. 

BackgroundColorDefault 

BackgroundColorDefault  is  an  externally  defined  routine  that  returns  an  XColor.  First 
.XnaBackgroundColorDefault  is  called,  and  then  die  resultant  Pixel  is  queried  to  produce  an 
lor.  The  caU  is  void  BackgroundColorDefault  (widget,  offset,  valPtr). 


1  Parameters  I 

Parameter 

Tvoe 

Where  Tvoedef  Declared 

widget 

Widoet 

See  Appendix. 

offset 

int 

See  Appendix. 

vaIRr 

XRMVakjeRr 

See  Appendix. 

CvtStringToMapStyle 

CvtStringfToMapStyle  is  an  externally  defined  routine  that  converts  map  style  keywords  to  the 
corresponding  style  constant  Its  call  is  void  CvtStringToMapStyle  (args,  nargs,  from  to). 


1  Parameters  1 

Parameter 

Type 

Where  Tvoedef  Declared 

arcs 

pointer  to  XimVahie 

See  Appendix. 

pointer  to  int 

See  Appendix. 

1  from,  to 

pointer  to  XimVahie 

See  Appendix. 

BBN  Systems  and  Technologies 


BBN  Report  No.  7628 


mapRegisterNames 

This  function  registers  callbacks  and  other  values  and  adds  a  converter  for  MapStyle.  The 
function  call  is  void  mapRegisterNames  (). 


mapInitWidgets 

mq)InitWidgets  gets  widget  pointers.  The  function  call  is  void  mapInitWidgets  (). 


i  Calls  1 

Function 

Where  Described 

NameToWidaet(Darent.  name) 

disDlay.c 

map_init_radio 

This  function  initializes  the  map  information  for  a  radio.  The  function  call  is  void 
map_init_radio  (rp). 


1  Parameters  1 

Parameter 

Tvoe 

Where  Tvoedef  Deciared 

ro 

RadioInfoP 

See  ADoendix. 

1  Caiis  1 

Function 

Where  Described 

state  find(st) 

state.c 

inap_allocate_coiors 

This  function  allocates  colors  for  the  map  display.  Only  four  writeable  colors  are  needed,  but 
all  colors  are  allocated.  The  function  call  is  void  map_^ocate_colors  0- 


map_animation_pixmap 

This  function  creates  one  of  eight  pixmaps  containing  a  succession  of  stripes  in  four  colors 
which,  when  animated,  will  apj^ar  to  move  north,  northeast,  east,  southeast,  etc.  The 
functitxi  call  is  Pixmap  map_animation_pixmap  (dir,  rootwiiidow). 
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1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

dir 

int 

See  Appendix. 

rootwindow 

Window 

See  Appendix. 

1  Return  Values  i 

Return  Value 

D 

Pixmao 

Drawing  CSV 

The  Drawing  CSU  contains  code  for  drawing  and  erasing  lightning  bolts  that  show 
connectivity. 


map_bounding_box 

This  function  updates  an  area  that  needs  to  be  redrawn  by  erasing  a  lightning  bolt  The  area  is 
simply  the  bounding  rectangle  covering  all  bolts  which  have  been  erased. 

The  function  call  is  void  map_bounding_box  (pts,  npts). 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

pts 

pointer  to  reoister  XPoint 

See  Appendix. 

int 

See  Appendix. 

map^draw^bolt 

This  function  draws  a  lightning  bolt  between  two  radios  according  to  indicated  connectivity 
types.  The  shape  of  the  bolt  has  already  been  determined  by  the  caller  (see 
map_shape_of_types).  The  function  call  is  Boolean  map_draw_bolt  (dpy,  wind,  rpl,  rp2, 
typel,  type2,  sha^,  mode). 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

dpy 

pointer  to  Display 

See  Appendix. 

wind 

Window 

See  Appendix. 

ITiWn  1  MBWBWlBBBiM 

RadioInfoP 

See  Appendix. 

tvoei.  tvoea 

unskined  char 

See  Appendix. 

shape 

unsioned  char 

See  Appendix. 
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I  mode  I  DRAW  +MODE  I  map.c  1 


1  Return  Values  1 

Return  Value 

Type 

Meanina 

False 

Boolean 

nothing  to  do;  omit  small 
separations 

Taie 

Boolean 

1  Calls  1 

Function 

I  Where  Described 

mao  boundinq  boxtpts.  nets) 

mao.c 

1  map  qc  of  tvDeftvpe,  lesser  tvoe,  qcp1, 

qcD2)  mao.c 

map_reset_pending_draw 

This  function  resets  the  map_pending_draw  infonnation  to  empty.  The  function  call  is  void 
map_reset_pending_draw  (). 


map_draw 

This  function  draws  bolts  on  the  map.  This  procedure  can  be  interrupted  by  pending  events, 
so  the  state  is  kept  in  map_pending_draw. 

The  procedure  is  as  follows:  For  every  pair  of  selected  radios,  connectivity  types  are  examined 
to  determine  a  drawing  mode.  If  the  tyj^s  are  marked  as  new,  the  mode  is  draw_mode_force. 
If  there  is  a  non-empty  box,  the  drawing  mode  is  draw_mode_box.  Otherwise  nothing  is 
drawn.  In  this  last  case,  the  pair  is  examined  further  to  determine  if  the  bolt  requires  animation 
in  order  to  maintain  the  map_some_animated  Hag;  otherwise  this  flag  is  maintained  as  a  side- 
effect  of  redrawing  the  bolt 

If  the  bolt  is  to  be  drawn,  its  shape  is  determined  and  the  bolt  is  drawn  using  map_draw_bolt 
The  type  and  shape  are  recorded  in  the  connectivity  arrays. 

After  all  bolts  have  been  (re)drawn,  color-map  animation  is  started  if  necessary. 

The  function  call  is  void  map_draw  (). 


Ca 

lls 

Function 

Where  Described 

map  style  of  type(tYPe) 

map  shape  of  typesftvpel,  type2) 

map_draw_bolt(dpy,  wind,  tpl,  rp2,  typel, 
tYpe2.  shape,  mode) 

map.c 
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iiiap_start_draw 

This  function  resets  tnap_pending_draw  state  and  starts  drawing.  The  function  call  is  void 
map_start_draw(). 


1  calls  1 

Function 

1  Where  Described  1 

mao  drawO 

inap_erase 

This  routine  is  similar  to  tnap.draw  except  that  bolts  are  erased  according  to  their  current  shape 
instead  of  being  drawn  in  their  new  shape.  Erasure  occurs  in  anticipation  of  a  subsequent 
draw.  Thus  if  the  draw  operatitm  will  cranpletely  cover  the  current  bolt,  no  erasure  is 
necessary.  This  is  an  important  q)tiinization  because  the  shape  being  erased  is  firquently 
covered  by  the  shape  being  drawn,  and  if  the  erasure  is  done  it  forces  redrawing  of  all  the  bolts 
which  intersect  the  erased  bolt 

As  bolts  are  erased,  the  area  erased  is  accumulated  to  determine  which  bolts  will  need  to  be 
redrawn. 

The  rules  about  which  shapes  cover  which  other  shapes  are: 

1.  Every  shape  covers  itself. 

2.  Everything  covers  the  invisible  shape. 

3 .  The  invisible  shape  covers  nothing  but  itself. 

4.  The  blunt.shape  and  sharp.blunt  shapes  cover  the  sharp_sharp  and  blunt_blunt 
shapes. 

5 .  The  sharp.sharp  and  blunt.blunt  shapes  cover  each  other. 

The  function  call  is  void  m2q)_erase  (). 


Ca 

lis 

Function 

Where  Described 

mao  shaoe  of  tvoesltvoel .  tvDe2) 

map_draw_bolt(dpy,  wind,  repi,  rp2,  typel, 
tvpe2.  shape,  nxxle) 

map.c 
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map_start_erase 

This  function  resets  niap_pending_draw  and  starts  erasing.  The  function  call  is 
map_start_erase  0- 


1  Calls  1 

Function 

Where  Described  1 

mao  erase!) 

map^expose 

If  a  map_draw  operadon  is  in  progress,  it  is  cancelled.  If  a  map.erase  operation  is  in  progress, 
it  is  left  alone.  T^en  the  exposed  area  is  added  to  the  inap_pending_draw  area.  If  a  map_erase 
operation  is  not  in  progress,  a  map.draw  is  started. 

The  function  call  is  void  inap_expose  (w,  a,  callback). 


1  Parameters  1 

Parameter 

Tvoe 

Where  Tvoedef  Declared 

w 

Widaet 

See  Apoendix. 

a 

caddr  t 

See  Aobendix. 

back 

pointer  to  XMDrawingArea 
CailbackStruct 

See  Appendix. 

1  Calls  1 

Function 

i  Where  Described  1 

map  start  draw!) 

inap_style_of_type 

This  routine  converts  a  connectivity  type  to  a  lightning  bolt  style.  The  default  bolt  shape  is 
unconnected.style.  The  function  call  is  MapStyle  map_style_of_type  (type). 


I  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

tvoe 

unsianed  char 

See  Appendix. 
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inap_shape_of_types 

This  function  returns  the  appropriate  bolt  shape  for  the  connectivity  types  between  a  pair  of 
radios.  The  function  call  is  unsigned  char  map_shape_of_types  (typel,  type2). 


1  Parameters  1 

Parameter 

Tvoe 

Where  Tvoedef  Declared 

tvoel 

unsianed  char 

See  ADoendix. 

unsianed  char 

See  ADoendix, 

1  Return  Values  I 

Return  Value 

MAP  SHAPE  SHARP 

SHARP 

unsigned  char 

MAP  SHAPE  SHARP 

BLUNT 

unsigned  char 

MAP  SHAPE  BLUNT 

SHARP 

unsigned  char 

MAP  SHAPE  BLUNT 

BLUNT 

unsigned  char 

map_gc_of_type 

Thu  function  converts  the  connectivity  types  between  two  radios  to  the  graphics  contexts  for 
rilling  the  two  halves  of  a  lightning  bolt  The  fimction  call  is  void  map_gc_of_type  (type, 
lesser_type,  gcpl,  gcp2). 


1  Parameters  1 

1  Parameter 

Type 

Where  Typedef  Declared 

unsigned  char 

See  Appendix. 

lesser  tvoe 

unsigned  char 

See  Appendix. 

gcpl.gcp2  _ 

pointer  to  GC 

See  Appendix. 
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map_set_connectivity 

This  function  sets  the  connectivity  of  "rpl"  from  the  "idx"  transmitter  to  "new_connectivity". 
It  filters  out  redundant  connectivity  changes  and  marks  the  connectivity  as  ”con_new".  It  Aen 
returns  bits  indicating  what  kind  of  changes  occurred.  The  function  call  is  int 
map_set_connectivity  (rpl,  idx,  ncw_connectivity). 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

rpl 

RadioInfoP 

See  Appendix. 

idx 

int 

See  Appendix. 

new  connectivity 

unskined  char 

See  Appendix. 

1  Return  Values  1 

Return  Value 

Type 

Meanina 

4 

int 

MAP  BECAME  DIFFERENT 

2 

int 

MAP  BECAME  NOT 
ANOMALOUS  ~ 

1 

int 

0 

int 

.  1 

niap_coIor_animate 

This  is  an  interval  timer  callback  for  doing  color-map  animation.  It  switches  the  colors  for  the 
animated  lightning  bolts  to  the  next  phase.  The  timer  is  restarted  if  there  are  still  sonte  animated 
bolts  present;  otherwise,  the  aiumation  stops.  The  function  call  is  void  map_color_animate  (). 


Map  Advancement  CSV 
mapjnput 

This  function  is  the  input  callback  for  vehicle  boxes.  Input  processing  is  only  performed  to 
permit  a  vehicle  box  to  be  dragged  to  a  new  location,  "^e  function  call  is  void  mapjnput  (w, 
vp,  event). 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

w 

Widaet 

See  Appendix. 

vp 

VehicleInfoP 

See  Appendix. 

eyent 

pointer  to  XEyent 

See  Appendix. 
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1  Calls  1 

Function 

1  Where  Described  1 

mao  color  radio(rp) 

mao  color  vehtcte(vp) 

1  mao.c  1 

IHIHB 

inap_step 

This  is  the  callback  function  for  activating  the  step  button.  It  calls  inap_advance  to  advance  one 
step.  The  function  call  is  void  map.step  0- 


1  calls  1 

Function 

Where  Described 

map_advance(up_to,  advance.mode, 
max  advance) 

map.c 

traffic  set  cursor  time(time) 

traffic.c 

map_step_to_anomaly 

This  callback  function  activates  the  anomaly  button.  It  calls  map.advance  to  advance  to  the 
next  anomaly.  The  function  call  is  void  map_step_to_anomaly  0- 


1  Calls  1 

Function 

Where  Described 

map_advance(up_to,  advance_mode, 
max  advance) 

map.c 

traffic  set  cursor  time(time) 

traffic.c 

map_free2e 

This  is  the  callback  function  fw  activating  the  fieeze  button.  It  desensitizes  the  freeze  button 
and  sensitizes  the  unfreeze,  step,  and  anomaly  buttons.  It  also  allows  input  to  the  time  widget 
If  the  traffic  display  is  already  frozen  and  has  a  valid  cursor,  the  map  time  is  advanced  to  the 
traffic  cursor  time.  Otherwise  the  traffic  cursor  tinoe  is  set  to  the  m^  time.  Tlie  function  call  is 
void  map_firceze  (). 


I 

I 
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1  Calls  1 

Function 

Where  Described 

map_advance(up_to,  advance_mode, 
max  advance) 

map.c 

traffic  set  cursor  time(time) 

traffic.c 

traffic  cursor  time(p) 

traffic.c 

inap_unfreeze 

This  is  the  callback  function  for  activating  the  unfreeze  button.  It  desensitizes  the  step, 
anomaly,  and  unfreeze  widgets,  sensitizes  the  freeze  button,  and  disables  input  to  the  time 
widget  The  map  time  is  advanced  to  the  current  time.  The  function  call  is  void  map_unfreeze 
(). 


1  Calls  1 

Function 

Where  Described 

map_advance{upjo,  advance_mode, 
max  advance) 

map.c 

map_reset 

This  function  resets  the  map.  It  is  called  when  a  new  set  of  data  is  started  (either  read  from  a 
file  or  when  the  user  restarts  on-line  collection).  The  function  call  is  void  map_reset  (). 


1  Calls  1 

Function 

Where  Described 

map  unfreezeO 

map  set  time(t) 

map  init  radiofro) 

mao  freezeO 

map_radio_transmit_time 

This  function  finds  the  latest  time  before  the  indicated  time  when  the  radio  transmitted.  The 
function  call  is  MSEC  map_radio_transmit_time  (rp,  when). 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

rp 

RadioinfoP 

See  Appendix. 

when 

MSEC 

See  Appendix. 

I 
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1  Return  Values  I 

Return  Value 

0 

MSEC 

tle->tle  when 

MSEC 

1  Calls  1 

Function 

Where  Described 

tIPrevrtlSD.  tleo) 

timeline.c 

mill  II  1 II  HIM  III  II— 

timeline.c 

inap_set_radio__time 

map_set_radio_time  sets  the  pointer  into  a  radio's  data  to  the  location  corresponding  to  the 
specified  dme.  The  function  call  is  void  tnap_set_radio_time  (rp,  when). 


1  Parameters  1 

Parameter 

Tvoe 

Where  Tvoedef  Declared 

rp 

RadioinfoP 

See  Aopendix. 

when 

MSEC 

See  Appendix. 

1  Calls  1 

Function 

Where  Described 

state  f!nd(st) 

state.c 

mini  ¥  n  1 1111111 1 1— 

timeline.c 

map_advance 

map.advance  advances  the  map  display  one  step.  First  it  finds  which  radio  has  the  earliest 
next  state.  If  this  state  has  a  new  tuning,  it  changes  all  connectivity  to  either  con.tuned  or 
con.untuned,  depending  on  whether  the  otlwr  r^o  is  tuned  the  same  or  not 

Next  we  ctxisider  whether  the  state  transition  is  the  initiation  or  termination  of  transmission  or 
reception.  In  each  case,  we  update  the  connectivity  accordingly.  A  complication  is  necessary 
due  to  Ae  possibility  that  PDU  transmission  delays  allow  cause  and  effect  to  be  reversed;  the 
beginning  of  transmission  may  follow  the  beginning  of  reception.  This  is  resolved  by 
examining  the  following  state  of  affected  radios  to  avoid  false  indications  of  lack  of 
connectivity. 
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Start  of  Transmission:  Scan  all  receivers  tuned  to  this  frequency.  A  receiver  which  is  tuned 
the  same  as  the  transmitter  should  be  receiving  firom  that  transmitter  or  should  be  doing  so  in 
the  next  state.  If  it  is  not,  then  there  is  either  a  conflict  or  a  lack  of  connectivity.  A  conflict  is 
indicated  when  the  receiver  is  busy  receiving  from  a  different  transmitter  or  is  itself 
transmitting.  These  two  connectivity  changes  are  made  now;  otherwise,  we  wait  until  the  next 
state  when  the  onset  of  reception  will  be  recorded. 

Start  of  Reception:  When  a  receiver  begins  receiving  from  a  transmitter,  the  connectivity 
becomes  con_receiving. 

End  of  Transmission:  Nothing  is  done  on  this  transition.  All  the  work  is  done  at  the  end  of 
reception  at  the  receivers. 

End  of  Reception:  Reception  can  cease  due  to  four  causes:  end  of  transmission,  loss  of 
signal,  reception  of  a  stronger  signal  (SC  mode  only),  or  start  of  transmission  by  the  receiver 
(double  push-to-talk).  End  of  transmission  is  determined  by  examining  the  state  of  the 
transmitter  (or  its  next  state)  to  see  if  it  is  still  transmitting  on  the  same  frequency.  If  not,  then 
this  is  a  normal  end  of  reception  and  the  connectivity  is  ir^ed  con.connected.  If  the 
transmitter  is  still  transmitting,  then  the  next  state  of  the  receiver  is  examined.  If  that  state  is 
only  a  short  time  in  the  future  and  is  ST_TRANSMl  l'i  iNG  or  ST_RECErVING,  then  the 
connectivity  becomes  con_conflicL  Otherwise,  the  connectivity  becomes  con_unconnected 

The  function  call  is  void  map_advance  (up_to,  advance_mode,  max_advance). 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

UD  to 

MSEC 

See  Appendix. 

advance  mode 

MAP  ADVANCE  MODE 

map.c 

max  advance 

MSEC 

See  Appendix. 

1  Calls  1 

Function 

Where  Described 

map  set  radio  timetrp.  when) 

1  map  set  timed) 

map.c 

map_set_connectivity(rp1,  idx, 
new  connectivity) 

map.c 

map  radio  transmit  time(rp,  when) 

mao  more  radiosO 

map_advance_display 

This  function  provides  the  public  interface  to  map_advance.  The  function  call  is  void 
map_advance_display  (up_to,  max_advance,  if_frozen). 


I 
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inap_vehicle_vanished 

D3ap_vehicle_vanished  marks  the  vehicle  as  needing  lecoloiing.  The  function  call  is  void 
map_vehicle_vanished  (vpl). 
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Selection  CSV 
inap_select 

This  is  the  callback  function  for  selecting  radios  to  show  on  the  connectivity  map.  The 
principal  function  is  to  set  the  r.map.selected  boolean  for  every  radio  which  is  selected  and  to 
clear  the  boolean  for  every  radio  not  selected.  The  manual  placement  of  the  vehicle  of  newly 
selected  radios  is  cancel!^  and  vehicle  lecoloring  is  scheduled  as  necessary. 
map_more_radios  is  called  to  schedule  the  map_display. 

The  function  call  is  void  map_select  (w,  a,  cback). 


1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

w 

Widoet 

See  Appendix. 

a 

caddr  t 

See  Appendix. 

cback 

DOinter  to  XMListCallbackStmct 

See  Appendix. 

1  Calls  1 

Function 

Where  Described 

map  more  radios!) 

map.c 

Map  Time  CSV 

ma  p_ti  me_cal  1  back 

This  is  the  callback  function  for  typing  in  a  new  map  time.  The  text  of  the  time  widget  is 
pars^  into  a  new  time  and  the  map  display  advanc^  to  that  time.  If  the  time  cannot  be  parsed, 
the  time  is  reset  to  the  cunent  map  time.  The  function  call  is  void  map_time_callback  (w,  a, 
cback). 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

w 

Widqet 

See  Appendix. 

a 

caddr  t 

See  Appendix. 

cback 

pointer  to  XMListCallbackStmct 

See  Appendix. 

1  Calls  1 

Function 

Where  Described 

map_advance{up_to,  advance.mode, 
max  advance) 

ntap.c 

map  set  time(t) 

traffic  set  cursor  time 

traffic.c  ! 

BBNRi 
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epoit 


map__set_time 

niap_set_tiine  changes  the  value  displayed  in  the  map_tinQe_widget.  The  function  call  is  void 
map_set_time  (t). 


1  Paramatars  1 

Paramatar 

Tvoa 

Whara  Tvoadef  Declared 

t 

MSEC 

See  Apoendix. 

Map  Display! Layout  CSV 
map_close 

The  map.widget  is  removed  from  the  screen  (unmanaged).  The  function  call  is  void 
map_close  (). 


map_display 

This  function  displays  the  map.  Brst  the  map_widget  is  created,  if  necessary.  Then  new  radio 
selection  buttons  are  created,  if  necessary.  TTien  new  vehicle  widgets  are  created,  if  necessary. 
Then  vehicle  widgets  are  remanaged  as  necessary.  The  map  is  remeasured  and  re-layed  out 
Then  the  map.wi^et  is  managed  if  it  is  not  already  on  the  screen;  otherwise,  it  is  re^wn  if 
any  of  the  piecedmg  operations  require  it  The  map  is  forced  into  the  frozen  state  in  offline 
mode.  The  function  call  is  void  mapjdisplay  Q. 


1  Calls  1 

Function 

Where  Described 

mao  freezeO 

mao.c 

mao  create  widaelO 

mao  create  vehicle  widaet(vD) 

mao  remanaoe  vehiclelvo) 

1 1  |i|| 

mao  lavoutO 

mao  create  radio  buttonsO 

mao  recoiorO 

map_display_move 

This  function  updates  the  position  of  a  vehicle  outline  box  while  dragging  the  vehicle  around. 
The  function  c^l  is  void  map_display_move  (visible,  x,  y). 


I 

I 
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1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

visible 

Boolean 

See  Appendix. 

III _ 

Position 

See  Appendix. 

inap_update 

This  function  updates  the  mq)  display  to  reflect  its  new  state.  It  recolors  everything  and  starts 
erasing  bolts.  The  function  call  is  void  map.update  (). 


map_vehicle_inoved 

This  function  schedules  a  map.display  operation  for  ten  seconds  from  now,  if  there  is  not 
already  a  map.display  pending.  The  function  call  is  void  tnap_vehicle_moved  (vp). 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

VP 

VehicleInfoP 

See  Appendix. 

map_inore_radios 

This  function  schedules  a  map.display  operation  for  50  milliseconds  from  now  if  there  is  not 
already  one  scheduled.  If  a  later  map_display  is  scheduled,  it  is  cancelled.  The  function  call  is 
void  map_more_radios  (). 


map_destroy 

nuq>_destroy  destroys  the  radio  selection  buttons  and  removes  the  map  display  from  the  screen. 
The  function  call  is  void  map.destroy  (). 


1  Calls  1 

Function 

Where  Described  1 

map  recolorO 

map  reset  pendina  drawO 

map  start  erc^  .el) 

49 


I 

BBN  Report  No.  7628  BBN  Systems  and  Technologies 


ma  p_crea  te_wi  dget 

This  function  creates  the  map  widget  and  initializes  things.  The  function  call  is  void 
map_create_widget  0- 


Ca 

lls 

Function 

Where  Described 

NameToWidoetiDarent.  name) 

1  II 1 II  I'i  — 1— — — — — 

mao  unfreezeO 

mao  allocate  colorsO 

mao  animation  oixmaoidir.  rootwindow) 

mao  set  timed) 

map_create_radio_buttons 

This  function  creates  selection  buttons  for  radios  which  have  recently  appeared.  The  function 
call  is  void  map_create_radio_buttons  (). 


1  Caiis  1 

Function 

Where  Described 

radio,  namelm) 

radmon.c 

niap_create_vehicle_widget 

This  function  creates  the  widget  for  a  vehicle.  The  various  widget  ids  are  recorded  in  the 
vehicle  or  radio  structures.  Event  handlers  are  added  for  dragging  the  widgets  around.  The 
radios  are  initially  unselected.  The  function  call  is  void  map_create_vehiclc_widget  (vp). 


1  Parameters  I 

Parameter 

Tvoe 

Where  Typedef  Declared 

VE _ 

VehiclelnfoP 

See  Appendix. 

1  Calls  1 

Function 

Where  Described 

set  wkJoet  labeliva  alist) 

status.c 

NameToWidoetioarent.  name) 

displav.c 

vehicle  name(vo) 

radmon.c 

map_reinanage_vehicle 
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This  function  changes  a  vehicle's  appearance  according  to  the  new  selection  state  for  the 
vehicle's  radios.  The  vehicle  is  unmanaged  if  neither  radio  is  selected.  If  a  radio  is  selected, 
then  the  label  and  separator  for  that  radio  are  managed,  if  necessary.  If  a  radio  is  not  selected, 
then  the  label  and  separator  for  that  radio  are  unmanaged,  if  necessary.  If  either  radio  is 
selected,  then  the  vehicle  is  managed,  if  necessary. 

The  function  call  is  Boolean  map_remanage_vehicle  (vp). 


1  Parameters  1 

Parameter 

Tvoe 

Where  Typedef  Declared 

_ 

VehicleInfoP 

See  Apoendix. 

1  Return  Values  1 

Return  Value 

need  redisplay 

Boolean 

1 

map_layout_compare_x 

This  function  allows  qsort  to  compare  the  x  coordinate  of  two  vehicles.  Ties  are  broken  by  the 
location  in  memory  of  the  vehicle  data.  The  function  call  is  int  map_layout_compare_x  (vppl, 
vpp2). 


1  Parameters  I 

1  Parameter 

Type 

Where  Typedef  Declared 

1 

pointer  to  VehicleInfoP 

See  Appendix. 

1  Return  Values  1 

Return  Value 

-1 

int 

1 

int 

0 

int 

niapJayout_compare_y 

This  function  allows  qsort  to  compare  the  y  coordinate  of  two  vehicles.  Ties  are  broken  by  the 
location  in  memory  of  the  vehicle  data.  The  function  call  is  int  map_layout_compare_y  (vppl, 
vpp2). 


1  Parameters  1 

1  Parameter 

Type 

Where  Typedef  Declared 

pointer  to  VehicleInfoP 

See  Appendix. 
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map_resize 

This  function  records  the  new  dimensitms  of  the  niap_body_widget.  The  function  call  is  void 
niap_resi2e  (w). 


Parameters 


Parameter 


w 


Where  Typedef  Declared 


See  A 
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map_color_radio 

This  function  changes  the  background  color  of  the  radio  label  widget  according  to  the  radio's 
state.  The  ftinction  call  is  void  map_color_radio  (rp). 


1  Parameters  1 

Parameter 

Type 

Where  Tvpedef  Declared 

JS. _ 

RadioInfoP 

See  Appendix. 

map_color_vehicle 

This  function  changes  the  background  color  of  the  vehicle  label  widget  according  to  the 
vehicle's  state.  The  function  c^l  is  void  map_color_vehicle  (vp). 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

V2 _ 

VehicleInfoP 

See  Appendix. 

map_recoIor 

This  function  recolors  all  vehicles  and  radios  as  needed-  The  function  call  is  void  map_recolor 

(). 


1  Calls  1 

Function 

Where  Described  1 

map  color  radio(rp) 

map  color  vehicie(vp) 

3. 2. 3. 2  Status  Summary  (status.c) 

The  Status  Summary  CSC  includes  routines  to  manipulate  the  Status  Display,  which  describes 
the  state  of  selected  radios.  Selecting  Status  displays  a  set  of  buttons  representing  all  selected 
radios.  Selecting  a  radio's  button  displays  a  box  that  describes  the  state  of  the  radio;  this  state 
information  is  updated  whenever  the  state  changes.  If  the  traffic  display  is  frozen,  the  status 
boxes  display  the  state  of  the  radios  at  the  time  selected  by  the  traffic  mark.  When  information 
in  a  box  changes,  the  changed  information  is  displayed  in  blue.  Old  information  is  shown  in 
black. 

This  CSC  consists  of  three  CSUs,  shown  in  Figure  3.2.3.2-1. 


53 


BBN  Report  No.  7628 


BBN  Systems  and  Technologies 


Status  Summary 
CSC 


Initialization 

Status  Display/Layout 

Selection 

Figure  3.2.3.2-1.  GUI — Status  Summary  CSC  Structure 


Initialization  CSV 

The  Initialization  CSU  contains  code  for  initializing  the  Status  Display,  hidividual  functions  in 
this  CSU  are  described  below. 


status_cIose_calI  back 

statusjclosejcallback  activates  the  callback  for  the  close  button  in  the  status  widget  and 
removes  the  status  box  from  the  screen.  The  function  call  is  void  status_close_callback(w,  rp, 
b). 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

w 

Widaet 

See  Appendix. 

m 

RadioInfoP 

See  Appendix. 

b 

caddr  t 

See  Appendix. 

statusRegisterNames 

This  functitxi  registers  names  for  Mnn.  The  function  call  is  void  stamsRegisrerNames(). 


statusInitWidgets 

This  function  gets  widget  IDs  for  status  widgets.  The  function  call  is  void  statusInitWidgetsQ- 
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create_status_widget 

This  function  is  used  for  creating  a  new  status  Mndget.  The  function  call  is  void 
crBate_status_widget(rp). 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

rp 

RadioInfoP 

See  Appendix. 

set_widget_Iabel 

This  function  is  essentially  SPRINTF  for  label  widgets.  The  function  call  is  void 
sct_widgct_label  (va_alist). 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

va  alist 

See  Appendix. 

set_status_label 

sct_status_label  is  the  same  as  set_widget .label  except  the  foreground  color  is  changed  to  the 
highlighted  color.  The  function  call  is  void  set.status.label  (va.alist). 


r  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

va  alist 

See  Appendix. 

Status  Display/ Layout  CSV 

This  CSU  contains  code  for  changing  the  layout . 

getUpdateFIags 

getUp^teFlags  computes  a  mask  of  status  fields  which  differ  between  two  states.  The  function 
call  is  int  getUpdateHags(old_state,  new.state). 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

old  state 

reaisterSTATEP 

See  Appendix. 

new  state 

reaisterSTATEP 

See  Appendix. 
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1  Return  Values  1 

1  Return  Value 

1  III  !■'  1 

int 

_ 

UTMString 

UTMString  gets  the  coordinate  string  for  a  given  position.  The  fimctitm  call  is  char 
♦UTMString  (x,  y). 


1  Parameters  1 

Parameter 

Type 

Where  Tvpedef  Declared 

X 

double 

See  Aooendix. 

Jf _ 

double 

See  ADoendix. 

1  Return  Values  1 

Return  Value 

Type 

Meanina 

str 

char 

Returns  static  storaoe 

status_new_radio 

status_iiew.jadio  is  called  when  a  new  radio  appears  in  order  to  create  its  selection  button. 
The  function  call  is  void  status_new_radio(ip). 


i  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

ro 

RadioInfoP 

See  Appendix. 

status_update 

status_update  updates  the  contents  of  a  status  box  according  to  the  new  state  of  a  radio.  K*  the 
traffic  wMget  has  a  valid  cursor,  the  time  of  that  cursor  is  used  to  find  the  state  to  be  displayed. 
In  this  case,  the  time  is  displayed  as  "Now"  to  avoid  extra  repainting.  If  the  traffic  cursor  is 
not  valid,  the  status  display  is  update  to  reflect  die  current  state  of  the  radio.  Only  changed 
fields  are  drawn.  The  function  call  is  void  status_update(rp). 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

JE _ 

RadioInfoP 

See  Appendix. 
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U  pdateRadioStatus 

UpdateRadioStatus  interfaces  to  status_new_radio  and  status.update  to  create  all  new  radio 
selection  buttt}ns  and  update  all  radio  status  displays.  The  fimction  call  is  void 
UpdateRadioStatusQ. 


create_status_select_button 

create_status_select_button  adds  a  button  to  select  the  status  of  a  new  radio.  The  function  call 
is  void  crcate_status_select_button(rp). 


1  Parameters  1 

Parameter 

Type 

Where  Tvpedef  Declared 

_ 

RadioInfoP 

See  Appendix . 

status_destroy 

status.destroy  deletes  all  status  buttons  and  status  widgets.  The  function  call  is  void 
status_destroy(). 


unhilite_widget 

unhilite.widget  restores  the  foreground  color  of  a  widget  to  the  unhighlighted  color.  The 
function  call  is  void  unhilite_widget(w). 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

w 

Widaet 

See  Appendix. 
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Selection  CSV 

This  CSU  contains  code  for  showing  which  radios  are  currently  selected. 


status_select 

status.select  is  called  when  the  set  of  selected  radios  changes.  It  changes  the  set  of  managed 
status  boxes  to  reflect  the  selected  radios.  The  function  c^  is  void  stams_select(w,  a,  cback). 


1  Parameters  1 

Parameter 

Type 

Whsre  Tvpedef  Declared 

w 

Widaet 

See  Apoendix. 

a 

caddr  t 

See  Aooendix. 

cback 

pointer  to 

XmButtonLCallbackstruct 

See  Appendix. 

3. 2. 3. 3  Stripchart  CSC  (trafnc.c) 

The  Stripchart  CSC  includes  routines  that  ctmtrol  the  trafiic  display,  which  consists  of 
hocizonol  lines  of  data  that  represent  the  state  of  radios  as  a  function  of  time.  There  are  four 
states:  non-existentdix>perative/not-ieceiving,  inactive,  transmitting,  and  receiving.  Thenon- 
existent^operadve/noMeceiving  state  is  represented  by  a  line  the  same  color  as  the 
background  (which  is  therefore  invisible).  The  inactive  state  is  represented  by  a  thin  black  line, 
the  transmitting  sute  by  a  thick  green  line.  The  receiving  state  is  represented  by  a  thick 
magenta  line. 

The  Stripchart  CSC  is  comprised  of  the  CSUs  shown  in  Figure  3.2.3.3-1. 


Stripchart  CSC 


Initialization 

Drawing 

Display/Layout 

Time 

Selection 


Figure  3.2.3.3-1.  GUI — Stripchart  CSC  Structure 
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Initialization  CSV 

The  Initialization  CSU  contains  code  for  initializing  the  Traffic  Display. 


trafficRegisterNames 

trafficRegisterNames  registers  names  to  be  used  by  mrm.  The  function  call  is  void 
trafficRegisterNamesO. 


trafndnitWidgets 

trafficInitWidgets  gets  widget  ids  for  the  various  button  lists.  The  function  call  is  void 
trafficInitWidgetsO- 


1  Calls  1 

Function 

Where  Described 

NamoToWklaetiDarent.  name) 

displavc 

traffic_anocate_coiors 

traffic_allocate_colors  allocates  colors  for  the  various  states  represented  in  the  traffic  display. 
It  allocates  one  plane  for  the  cursor  so  it  can  be  drawn  independently  of  the  traffic  lines.  The 
function  call  is  void  traffic_allocate_colors(trf). 


1  Parameters  1 

Parameter 

Tvoe 

Where  Tvoedef  Declared 

trf 

TRAFFICINFOP 

See  ADoendix. 

Drawing  CSU 

The  Drawing  CSU  consists  of  routines  for  drawing  and  erasing  traffic  slots  and  labels. 


traffic_draw_cursor 

This  function  draws  the  cursor  and  mark.  The  function  call  is  void  traffic_draw_cursor(trf). 
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Parameter 


trf 


Parameters 


TRAFFICINFOP 


Where  Tvoedef  Declared 


See  ADoendix. 


traffic_erase_cursor 

trafficjerasejcursor  erases  the  cursor  and  mark.  The  function  call  is  void 
traffic_erase_ctirsor(tif). 


Parameter 


Parameters 


TRAFFICINFOP 


Where  Tvoedef  Declared 


See  ADoendix. 


traffic_erase_labels 

traffic_erase_labels  erases  (and  then  redraws)  the  labels  for  the  given  slots.  The  function  call  is 
void  traffic_erase_labels(trf,  first_slot,  last_slot). 


Parameters 


Parameter 


trt 


first  slot 


last  slot 


TRAFFICINFOP 


int 


int 


Where  Tvoedef  Declared 


See  ADoendix. 


See  Aooendix. 


See  Appendix. 


Function 


traffic  set  scrollbarftrt 


Calls 


Where  Described 


traffic.c 


traffic_erase_drawlng 

trafflc_erase_drawing  erases  (and  then  redraws)  the  traffic  drawing.  The  function  call  is  void 
traffic_erase_drawing(trf). 
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traffic_draw_Iabel 

traffic_draw_label  draws  the  label  for  the  given  slot.  The  function  call  is  void 
traffic_draw_label(af,  slot). 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

trf 

TRAFFICINFOP 

See  Appendix. 

slot 

int 

See  Appendix. 

traffic_draw_slot 

traffic_draw_slot  draws  the  data  for  the  given  slot  starting  a  position  "left”  on  the  screen  and 
continuing  for  "width"  pixels.  For  each  state  change,  a  graphics  context  is  selected  according 
to  the  previous  state,  and  a  line  is  drawn  using  that  graphics  context  from  the  previous  position 
to  the  position  of  the  state  change.  Transmissions  are  emphasized  by  drawing  the  lines  for 
transmission  one  pixel  farther  than  for  other  states.  The  function  call  is  int 
traffic_draw_slot(trf,  slot,  left,  width). 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

trf 

TRAFFICINFOP 

See  Appendix. 

slot 

int 

See  Appendix. 

left 

int 

See  Appendix. 

width 

int 

See  Appendix. 

1  Return  Values  1 

Return  Value 

Type 

Meanina 

ridht 

int 

All  done 

Ca 

Is 

Function 

Where  Described 

timeline.c 

TIME  TO  WINDOW  COORDdrf.  t) 

traffic.c 

WINDOW  TO  TIME  COORDdrf.  x) 

traffic.c 

tune  selectedfbi.  tune) 

tune.c 
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I 

trafnc_draw_labels  « 

traffic_draw_labels  draws  the  labels  for  all  slots.  The  function  call  is  void  ^ 

traffic_draw_labels(trf,  first_slot,  last_slot). 


1  Parameters  I 

Parameter 

Type 

Where  Tvpedef  Declared 

trf 

TRAFFICINFOP 

See  Appendix. 

first  slot 

int 

See  Appendix. 

last  slot 

int 

See  Appendix. 

1  Calls  1 

Function 

Where  Described 

traffic  draw  label 

traffic.c 

traffic_draw_grid 

traffic_draw._grid  draws  and  labels  the  traffic  label.  The  function  call  is  void  traff_draw_grid 
(trf,  left,  width). 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

trf 

TRAFFICINFOP 

See  Appendix. 

left 

int 

See  Appendix. 

width 

See  Appendix. 

1  Calls  1 

Function 

Where  Described 

traffic  fomiat  timeftrf.  timel 

traffic.c 

TIME  TO  WINDOW  COORDftrf,  t) 

traffic.c 

WINDOW  TO  TIME  COORDftrf,  x) 

traffic.c 

traffic_draw_slots 

trafBc_draw_slots  draws  slots  in  the  indicated  region.  The  function  call  is  void 
traffic_draw_slots(trf,  first_slot,  Iast_slot,  left,  width). 
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traffic_redraw_labels 

traf!ic_rBdraw_labels  exposes  the  callback  for  the  label  area  and  redraws  the  labels  included  in 
the  exposed  area.  TTie  function  call  is  void  traffic_redraw_labels(w,  trf,  cback). 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

w 

Widqet 

See  Appendix. 

trt 

TRAFFICINFOP 

See  Appendix. 

cback 

pointer  to  XmDrawingAreaCall- 
backStruct 

See  Appendix. 

1  Calls  1 

Function 

Where  Described 

traffic  draw  labeisftrf,  first  slot,  last  slot) 

traffic.c 

traffic_iedraw 

traffic_redraw  redraws  traffic  slots.  The  function  call  is  void  traffic_redraw(trf,  left,  top, 
width,  height). 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

trf 

TRAFFICINFOP 

See  Appendix. 

left 

int 

See  Appendix. 

too 

int 

See  Appendix. 

width 

int 

See  Appendix. 

heiaht 

int 

See  Appendix. 
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1  Calls 

Function 

Where  Described 

trafflc_draw_slots(trf,  firstjslot,  last_slot,  left, 
width) 

1  traffic.c 

traffic_expose 

traffic.expose  exposes  the  callback  for  the  traffic  display  and  redraws  the  exposed  slots.  The 
function  call  is  void  tra£fic_expose(w,  trf,  cback). 


Parameter 


w 


trf 


cback 


Parameters 


Where  Tyoedef  Declared 


Widaet  1  See  Aobendix. 


TRAFFICINFOP  See  Apoendix. 


pointer  to  XmOrawingAreaCall*  See  Appendix. 
backStruct 


Function 


trf.  left,  too,  width,  he 


Calls 


Where  Described 


trafflc.c 


trafnc_graphics_expose 

traffic_graphics_expose  provides  the  graphics  expose  callback  for  the  traffic  display  and 
redraws  the  exposed  slots.  The  function  caU  is  void  traffic_graphiC5_expose(w,  trf,  event). 


Parameter 


w 


trf 


event 


Parameters 


Widaet 


TRAFFICINFOP 


inter  to  XEvenI 


Where  Tyoedef  Declared 


See  ADoendix. 


See  Appendix. 


See  Appendix. 


Function 


traffic  redrawftrf.  left,  tp.  width,  height 


Calls 


Where  Described 


traffic.c 
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traffic  resize 


This  function  is  the  resize  callback  for  traffic  drawing  widget  It  records  the  new  dimensions, 
sets  the  scrollbar  parameters,  and  recomputes  the  ^d  parameters.  The  concomitant  redrawing 
is  initiated  by  the  expose  event  The  fimction  call  is  void  traffic_resize(w,  trf,  cback). 


1  Parameters  I 

Parameter 

Type 

Where  Tvpedef  Declared 

w 

Widqet 

See  Apoendix. 

trf 

TRAFFiCINFOP 

See  Appendix. 

cback 

pointer  to  XmOrawingAreaCall- 
backStruct 

See  Appendix. 

1  Calls  1 

Function 

Where  Described 

traffic  set  scrollbarttrh 

traffic.c 

traffic  measure  aridftrf) 

traffic.c 

traffic_set_offset 

traffic_set_offset  changes  the  drawing  offset  to  a  new  value.  It  calls  traffic_left  or 
traffic_right  as  needed  to  accomplish  this.  The  fimction  call  is  traffic_set_offset(trf, 
new_offset). 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

trf 

TRAFFICINFOP 

See  Appendix. 

new  offset 

int 

See  Appendix. 

1  Calls  1 

Function 

Where  Described 

traffic  leftftrf,  delta,  limit) 

traffic.c 

traffic  rkjhtftrf,  delta) 

traffic.c 

traffic_new_height 

traffic_new_height  confutes  a  new  height  for  the  traffic  widget  and  changes  it  if  necessary. 
The  function  call  is  void  traffic_new_height(trf). 


I 
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Display/Layout  CSV 

The  Display/Layout  CSU  contains  code  for  laying  out  and  displaying  items  on  the  traffic 
display. 


TIME_TO_WINDOW_COORD 

This  function  converts  from  time  to  position  in  the  traffic  window.  The  function  call  is  int 
'ITME_TO_WINDOW_COORD(trf,t). 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

trf 

TRAFFICINFOP 

See  Appendix. 

t 

MSEC 

See  Appendix. 

1  Return  Values  1 

Return  Value 

2147483647 

int 

-2147483647 

int 

X 

int 

WINDOW_TO_TIME_COORD 

This  function  converts  from  window  position  to  time.  The  function  call  is  MSEC 
WINDOW_TO_TIME_COOE«D(trf^). 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

trf 

TRAFFICINFOP 

See  Appendix. 

X 

int 

See  Appendix. 

I  Return  Values 

I  Type 


Return  Value 

2147483647 

-2147483647 


int 

int 
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u. 


I  MSEC 


TIME_TO_WINDOW_DELTA 

This  function  converts  from  a  time  dimension  to  a  window  dimension.  The  function  call  is  int 
TIME_TO_WINDOW_DELTA(tif.t). 


1  Parameters  1 

Parameter 

Type 

Where  Tvpedef  Declared 

trf 

TRAFFICINFOP 

See  Appendix. 

t 

MSEC 

See  Appendix. 

1  Return  Values  1 

Return  Value 

2147483647 

int 

-2147483647 

int 

X 

int 

WINDOW_TO_TIME_DELTA 

This  function  converts  from  a  window  dimension  to  a  time  dinoension.  The  function  call  is 
MSEC  WINDOW_TO_TIME_DELTA(trf,x). 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

trf 

TRAFFiCINFOP 

See  Appendix. 

X 

int 

See  Appendix. 

1  Return  Values  1 

Return  Value 

2147483647 

int 

-2147483647 

int 

t 

MSEC 

traffic_set_scrollbar 

traffic_set_scrollbar  updates  scrollbar  variables  to  reflect  a  new  position  or  size.  The  function 
call  is  void  traffic_set_scrollbar(trf). 
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traffic_measure_grid 

traffic_n]easure__grid  Hguxes  out  how  to  lay  out  and  label  the  grid  on  the  traffic  display.  The 
grid  is  constrained  to  increment  by  the  list^  amounts  and  the  grid  interval  is  selected  to  place 
no  more  than  8  ticks  on  the  display.  If  the  number  of  ticks  chosen  would  result  in  labels 
overlapping,  the  number  of  ticlb  is  reduced.  The  function  call  is  Boolean 
traffic_measure_grid(trf). 
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traffic_close 

This  function  activates  the  callback  for  the  "close"  button  and  removes  the  traffic  widget  from 
the  screen.  The  function  call  is  void  traffic_close(w,  trf,  cback). 


1  Parameters  1 

Parameter 

Tvoe 

Where  Tvpedef  Declared 

w 

Widqet 

See  Appendix. 

trf 

TRAFFICINFOP 

See  Appendix. 

cback 

caddr  t 

See  Appendix. 

traffic__zoom_in 

traffic_zoom_in  activates  the  callback  for  the  zoom  in  button.  It  adjusts  the  scale  and  offset  of 
the  drawing  so  the  area  between  the  mark  and  cursor  falls  between  the  left  and  right  extremes 
of  the  display.  If  the  cursor  is  not  valid,  the  scale  is  doublesd,  keeping  the  left  edge  constant 
The  function  call  is  void  traffic_zoom_in(w,  trf,  cback). 


1  Parameters  1 

Parameter 

Type 

Where  Tvpedef  Declared 

w 

Widaet 

See  Appendix. 

trf 

TRAFFICINFOP 

See  Appendix. 

cback 

caddr  t 

See  Appendix. 

1  Calls  1 

Function 

Where  Described 

WINDOW  TO  TIME  COORDItrf.  x) 

traffic.c 

TIME  TO  WINDOW  DELTArtrf.t) 

traffic.c 

traffic  cursor  invalid(trf) 

traffic.c 

traffic  set  scrollbarttiD 

traffic.c 

traffic  erase  drawina(trf) 

traffic.c 

traffic  measure  arid(trf) 

traffic.c 

traffic  freezefw.  trf.  cback) 

traffic.c 

traffic_zoom_out 

trafflc_zoom_out  activates  the  callback  for  the  zoom  out  button.  It  adjusts  the  scale  and  offset 
of  the  drawing  so  the  area  between  the  left  and  right  extremes  of  the  display  falls  between  the 
mark  and  ciffsor.  If  the  cursor  is  not  valid,  the  scale  is  halved,  keeping  the  left  edge  constant. 
The  function  call  is  void  traffic_zoom_out(w,  trf,  cback). 


traffic^Ieft 

traffic.left  scrolls  the  traffic  display  left  by  the  indicated  amount  The  scroll  distance  is  limited 
so  that  the  right  data  extreme  is  not  less  than  "linoit’’.  The  cursor  is  moved  so  it  stays  with  the 
data.  The  gi^  is  remeasured.  The  function  returns  False  if  no  scrolling  is  possible.  The 
function  ct^  is  Boolean  traffic_left(trf,  delta,  limit). 
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trafnc_continue_pan_left 

This  function  is  a  timer  routine  to  perform  another  step  of  panning  to  the  left  It  restarts 
another  timer  if  scrolling  occurs.  The  function  call  is  void  traffic_continue_pan_left(trf,  id). 


1  Parameters  1 

Parameter 

Tvoe 

Where  Typedef  Declared 

trf 

TRAFFICINFOP 

See  Appendix. 

id 

Xtintervalld 

See  Appendix. 

1  Calls  1 

Function 

Where  Described 

traffic  left 

traffic.c 

traffic  set  scrollbaittrf) 

traffic.c 

traffic_pan_left 

trafficjpanjeft  initiates  or  terminates  panning  left  Arming  the  pan  left  button  starts  panning. 
Disarming  terminates  panning.  The  function  call  is  void  ti^c_pan_left(w,  trf,  cback). 


1  Parameters  1 

Parameter 

Tvoe 

Where  Typedef  Declared 

w 

Widqet 

See  Appendix. 

trf 

TRAFFICINFOP 

See  Appendix. 

cback 

caddr  t 

See  Appendix. 

1  Calls  1 

Function 

Where  Described 

traffic  continue  pan  left 

traffic.c 

traffic_right 

traffic.right  scrolls  the  traffic  display  right  by  the  indicated  amount.  The  scroll  distance  is 
limited  so  that  the  left  data  extreme  is  not  greater  than  10.  The  cursor  is  moved  so  it  stays  with 
the  data.  The  grid  is  remeasured.  The  function  returns  False  if  no  scrolling  is  possible.  The 
function  call  is  Boolean  traffic_right(trf,  delta). 
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trafnc_continue_pan_right 

traffic_continue_pan_right  is  a  timer  routine  to  perform  another  step  of  panning  to  the  right 
It  restarts  another  timer  if  scrolling  occurs.  The  function  call  is  void 
traffic_continue_pan_right(trf,  id). 


1  Parameters  I 

Parameter 

Type 

Where  Tvoedef  Declared 

trf 

TRAFFICINFOP 

See  Appendix. 

id 

Xtintervalld 

See  Appendix. 

Ca 

Is 

Function 

Where  Described 

traffic  set  scrollbarftrf) 

traffic.c 

traffic  riahtitrf.  delta) 

traffic.c 

traffic_pan_right 

traffic_pan_right  initiates  or  terminates  panning  right  Arming  the  pan  right  button  starts 
panning;  disarming  temunates  panning.  The  function  call  is  void  traffic_pan_right(w,  trf, 
cback). 
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1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

w 

Widaet 

See  Appendix. 

trf 

TRAFFICINFOP 

See  Appendix. 

cback 

caddr  t 

See  Appendix. 

1  Calls  1 

Function 

Where  Described 

traffic  continue  pan  riahtftrf,  id) 

traffic.c 

traffic_fit 

iraffic_fit  is  the  callback  for  the  fit  button.  It  adjusts  the  scale  and  offsets  to  fit  the  entire  data 
in  the  window.  The  function  call  is  void  traffic_fit(w,  trf,  cback). 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

w 

Widqet 

See  Appendix. 

trf 

TRAFFICINFOP 

See  Appendix. 

cback 

caddr  t 

See  Appendix. 

1  Calls  1 

Function 

Where  Described 

traffic  unfreezefw,  trf,  cback) 

traffic.c 

traffic  set  scrollbarttrf) 

traffic.c 

traffic  erase  drawina(trf) 

traffic.c 

traffic  measure  arid(trf) 

traffic.c 

I 

traffic_freeze 

traffic_&eeze  is  the  callback  for  freeze  button.  It  prevents  the  traffic  display  from  scrolling, 
sensitizes  the  unfreeze  button,  and  desensitizes  the  freeze  button.  The  function  call  is  void 
traffic_frceze(w,  trf,  cback). 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

w 

Widqet 

See  Appendix. 

trf 

TRAFFICINFOP 

See  Appendix. 

cback 

caddr  t 

See  Appendix. 
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traffic_unfree2e 

traffic_unfteeze  is  the  callback  for  unfreeze  button.  It  allows  the  nraffic  display  to  scroll, 
sensitizes  the  fi:eezB  button,  and  desensitizes  the  unfreeze  button.  The  function  call  is  void 
traffic_unfreeze(w,  trf,  cback). 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

w 

Widqet 

See  Appendix. 

trf 

TRAFFiClNFOP 

See  Appendix. 

cback 

caddr  t 

See  Appendix. 

1  Calls  1 

Function 

wnere  Described 

traffic  cursor  invalid(trf) 

traffic.c 

traffic  erase  cursorftrf) 

traffic.c 

traffic^input 

traffic.input  is  the  input  callback  for  the  traffic  drawing  widget.  It  sets  the  cursor  and  mark  to 
where  the  left  button  is  pressed  and  released  respectively.  The  function  call  is  PRIVATE  void 
traffic_input(w,  trf,  cback). 
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traffic_scroIlbar 

traffic_scrollbar  is  the  callback  for  the  traffic  scrollbar.  It  cCalls  traffic_set_offset  to  set  the  new 
position  as  selected  by  the  scrollbar.  The  function  call  is  void  traffic_scrollbar(w,  trf,  cback). 


1  Parameters  1 

Parameter 

Where  Tvpedef  Declared 

w 

Widqet 

See  Appendix. 

trf 

TRAFFICINFOP 

See  Appendix. 

cback 

caddr  t 

See  Appendix. 

Ca 

IIS 

Function 

Where  Described 

traffic  set  offsetttrf,  new  offset) 

traffic.c 

WINDOW  TO  TIME  COORDftrf.  x) 

traffic.c 

TIME  TO  WINDOW  COORDftrf.  t) 

traffic.c 

traffic  set  scrollbarftrf) 

traffic.c 

traffic_motion 

traffic_motion  updates  the  mark  position  as  the  mouse  is  dragged  across  the  traffic  display.  The 
function  call  is  void  traffic_motion(w,  trf,  event). 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

w 

Widqet 

See  Appendix. 

trf 

TRAFFICINFOP 

See  Appendix. 

event 

pointer  to  XEvent 

See  Appendix. 

1  Calls  1 

Function 

Where  Described 

traffic  draw  cursorftrf) 

traffic.c 

traffic  erase  cursorftrf) 

traffic.c 

traffic_create_widget 

traffic_create_widget  creates  a  traffic  widget  and  fills  in  its  associated  data  structure.  The 
function  call  is  void  traffic_create_widget(trf). 
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1  Parameters  1 

Parameter 

Type 

Where  Tvpedef  Declared 

trf 

TRAFFICINFOP 

See  Appendix. 

Ca 

is 

Function 

Where  Described 

traffic  measure  aridftrf) 

traffic.c 

traffic  allocate  colors(trf) 

traffic.c 

NameToWidaet(parent.  name) 

displav.c 

set  widaet  labeKva  alist) 

status. c 

traffic  cursor  invalidftrf) 

traffic.c 

traffic_add_pos 

This  function  adds  a  new  slot  to  the  traffic  display  for  the  radio  button  in  the  indicated  position. 
The  function  call  is  Boolean  traffic_addjx)s(trf,  position). 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

trf 

TRAFFICINFOP 

See  Appendix. 

position 

int 

See  Appendix. 

1  Return  Values  1 

Return  Value 

Type 

Meanina 

False 

Boolean 

No  room 

True 

Boolean 

1  Calls  1 

1  Function 

Where  Described 

traffic.c 

1  radio  name(rp) 

radmon.c 

t  ra  ffic_delete_pos 

This  function  deletes  the  slot  for  the  radio  button  at  the  indicated  position.  The  function  call  is 
void  traffic_delete_pos(trf,  position). 


I 

I 

I 

I 
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Parameters 

Parameter 

Where  Tvpedef  Declared 

trf 

1 TRAFFICINFOP  1 

See  Appendix. 

sition 


See  Appendix. 


Function 


Calls 


Where  Described 


traffic.c 


traffic_create_radio_button 

traffic_cieate_radio_button  adds  a  new  radio  selection  button  to  the  button  list  It  is  called 
when  a  new  radio  appears.  The  function  call  is  int  traffic_create_radio_button(trf,  rp). 


traffic_create_tune_button 

traffic_create_tune_button  adds  a  new  tuning  button  to  the  button  list  It  is  called  when  a  new 
radio  tuning  appears.  The  function  call  is  int  traffic_CTcate_tune_button(trf,  tune). 
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1  Return  Values  1 

Return  Value 

Type 

Meanina 

num 

int 

Button  already  exists 

traffic_reset 

traffic.teset  resets  the  traffic  display  back  to  its  ground  state.  The  function  call  is  void 
traffic_reset(). 


Ca 

IIS 

Function 

Where  Described 

traffic  cursor  invalidftrfl 

traffic.c 

traffic  set  scrollbarftrf) 

traffic.c 

traffic  erase  drawinaftrf) 

traffic.c 

traffic  measure  arid(trf) 

traffic.c 

traffic  unfreezefw.  trf.  cback) 

traffic.c 

traffic_new_tune 

traffic_new_tune  adds  a  new  tuning  button.  The  function  call  is  void  traffic_new_tune(tune). 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

tune 

TUNEP 

See  Appendix. 

Ca 

Is 

Function 

Where  Described 

traffic  create  widaetftrf) 

traffic.c 

traffic  create  tune  buttonftrf.  tune) 

traffic.c 

traffic_new_radio 

traffic_new_radio  adds  a  new  radio  selection  button.  The  function  call  is  void 
traffic_new_radio(rp). 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

J2 _ 

RadioInfoP 

See  Appendix. 
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1  Calls  1 

Function 

Where  Described 

traffic  create  radio  buttonftrf,  rp) 

traffic.c 

trafnc_update 

traffic_update  updates  the  traffic  display  and  create  the  traffic  widget,  if  necessary.  It  scrolls  if 
necessary  and  gives  permission  to  keep  the  present  time  on  the  screen.  The  function  call  is 
void  traffic_update(). 


1  Calls  1 

Function 

Where  Described 

traffic  set  scrollbarftrf) 

traffic.c 

traffic  leftftrf.  delta,  limit) 

traffic.c 

traffic  create  widaet(trf) 

traffic.c 

UpdateRadioTraffic 

UpdateRadioTraffic  adds  new  radios  if  necessary  and  keeps  the  traffic  display  up  to  date.  The 
function  call  is  void  UpdateRadioTrafficO* 


1  „  Calls  1 

Fimctlon 

Where  Described 

traffic  uDdateO 

traffic.c 

traffic  new  radiofro) 

traffic.c 

traffic_destroy 

traffic_destroy  destroys  resources  allocated  for  the  traffic  display.  The  function  call  is  void 
traffic_desiroy(). 


i  Calls  1 

Function 

Where  Described 

traffic  delete  twsftrf.  position) 

traffic.c 
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eport 


tune_selected 

tune_selected  tests  if  the  specified  tuning  is  cuncndy  selected.  The  buttons  given  by  "bi"  are 
scanned  looking  for  the  one  that  matches  the  tuning  and  returning  its  selected  state.  The 
function  call  is  Boolean  tune_selected(bi,  tune). 


1  Parameters  1 

Parameter 

Tvoe 

Where  Typedef  Declared 

bi 

BUTTONINFOP 

See  Appendix. 

tune 

TUNEP 

See  Appendix. 

1  Return  Values  1 

Return  Value 

pbooi 

pointer  to  Boolean 

False 

Boolean 

Time  CSV 

The  Time  CSU  contains  code  for  controlling  time  functions  on  the  traffic  display. 


traffic_cursor_valid 

traffic_cursor_valid  makes  the  current  traffic  cursor  valid.  The  status  widgets  are  updated  to 
reflect  the  new  time.  The  function  call  is  void  traffic_cursor_valid(trf). 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

trt 

TRAFFICINFOP 

See  Appendix. 

traffic_cursor_invaIid 

traffic.cursor.invalid  makes  the  current  traffic  cursor  invalid.  The  status  widgets  are  updated 
to  reflect  the  present  time.  The  function  call  is  void  traffic_cursor_invalid(trf). 


1  Parameters  i 

Parameter 

Type 

Where  Typedef  Declared 

trf 

TRAFFICINFOP 

See  Appendix. 

80 


BBN  Systems  and  Technologies 


BBN  Report  No.  7628 


traffic_set_cursor_time 

traffic_set_cursar_tiiiie  moves  the  traffic  cursor  to  a  specific  time.  The  traffic  display  is 
frozen  if  it  was  not  previously.  The  displayed  is  scroUed  as  necessary  to  bring  the  selected 
time  into  view.  The  fiinctitm  call  is  void  tr£ffic_set_cursor_time(time). 


Parameters 


Parameter 


time 


Function 


e 


MSEC 


Where  Tvoedef  Declared 


See  ADoendix. 


traffic  teftftrf.  delta,  limit 


traffic  riahtftrf,  delta 


traffic  freezefw,  trf,  cbacK 


TIME  TO  WINDOW  COORDftrf.  t 


Calls 


Where  Described 


traffic.c 


traffic.c 


traffic.c 


traffic.c 


traffic.c 


traffic.c 


traffic.c 


traffic.c 


traffic_cursor_time 

traffic_cursor_time  returns  the  time  of  the  current  traffic  cursor.  If  the  cursor  is  not  valid,  the 
present  time  (now)  is  returned  and  the  function  value  is  FALSE.  The  function  call  is 
BCXDLEAN  traffic_cursor_time(p). 
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traffic_format_tiine 

traffic_format_tinje  c(»istructs  a  label  for  a  given  dme.  tr_grid_first_format  and 
tr_grid_last_format  give  the  range  of  fields  required  for  the  current  scaling.  These  values 
essentially  discard  high-order  fields,  which  are  always  zero  in  the  ciurent  scaling,  and  low- 
order  fields,  which  are  not  necessary  to  resolve  the  grid  markings.  Thus,  if  the  display  must 
represent  non-zero  hours  and  the  grid  markings  are  multiples  of  5  seconds,  the 
tr_grid_first_fonnat  will  be  DATE_HOURS  and  tr_grid_last_format  will  be 
DATE.SECONDS. 

The  first_formats  array  gives  the  format  of  the  first  field.  Generally,  this  discards  leading 
zeros.  The  middle_formats  array  gives  the  format  of  intermediate  fields.  Generally,  this 
retains  all  leading  zeros  in  the  field.  The  final_formats  array  gives  the  format  of  the  last  field. 
Generally,  this  includes  suffixes  which  disambiguate  the  result  (e.g.,  hh:mm  is  augmented  to 
hh:mm:()0  to  distinguish  if  from  mm:ss).  The  only_formats  array  combines  the 
first_formats  and  last_fonnats. 

The  function  call  is  char  *  traffic_format_time(trf,  time). 


traffic_format_traffic_time 

This  function  formats  a  time  value  for  the  main  traffic  widget  The  function  call  is  char  * 
traffic_forniat_traffic_tiriie(tiriie). 
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Function 


traffic  format  timeftrf,  time 


Calls 


Where  Described 


traffic.c 


traffic_time_to_date_fieId 

traffic-Time_to_date_field  returns  the  ceiling  date  type  for  the  specified  time.  The  function  call 
is  DATE_FIELDS  traffic_time_to_date_field(time). 


Parameter 


time 


Parameters 


Where  Tvoedef  Declared 


See  AoDendix. 


Return  Values 


Return  Value 


DATE  DAYS 


DATE  HOURS 


DATE  MINUTES 


DATE  SECONDS 


DATE  M 


DATE  OM 


DATE  OOM 


DATE  FIELDS 


DATE  FIELDS 


DATE  FIELDS 


DATE  FIELDS 


DATE  FIELDS 


DATE  FIELDS 


DATE  FIELDS 


Selection  CSU 
traffic_sub_select 

traffic_sub_select  is  the  callback  for  traffic  selection  buttons.  It  adds  and  deletes  radios  from 
the  display  as  indicated  by  the  selections.  The  function  call  is  void  traffic_sub_select(w,  bi, 
cback). 
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Ca 

Is 

Function 

Where  Described 

traffic  erase  labeisftrf.  first  slot,  last  slot) 

traffic.c 

traffic  erase  drawinaftrf) 

traffic.c 

traffic.c 

1  traffic  delete  oosftrf,  position) 

traffic.c 

3. 2. 3. 4  Statistics  CSC  (state.c) 

The  Statistics  CSC  contains  code  for  presenting  a  sumn^  of  radio  activity  in  the  State 
Display.  Its  routines  manipulate  states  and  compile  statistics  for  those  states.  When  the  "State" 
button  is  selected,  a  three  sub-function  buttons  appear 

•  The  Radio  button  presents  radio  selection  buttons.  Summary  information  is  presented 
for  the  radios  selected  fimm  this  panel. 

•  The  Attributes  button  presents  attribute  selection  buttons.  Selected  attributes  determine 
which  states  are  included  in  the  summary. 

•  The  Smrus  button  presents  stams  type  selection  buttons. 

The  state  display  consists  of  one  or  more  rows  of  information,  which  rsummarize  one  or  more 
staradios.  Each  column  contains  the  value  of  an  attribute  or  statistic  for  those  states.  Statistics 
include: 


•  The  percentage  of  all  time  spent  in  the  state 

•  The  number  of  times  a  radio  was  in  this  state. 

•  The  average  duration  of  time  spent  in  this  state. 

•  The  maximum  duration  of  time  spent  in  this  state. 


The  State  Display  CSC  consists  of  seven  CSUs,  shown  in  Figure  3.2.3.4-1. 
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Statistics  Summary 
CSC 


Initialization 

Drawing 

Display/Layout 

Selection 

Processing 

Storage 

State  Manipulation 

Figure  3.2.3.4-1.  GUI — State  Display  CSC  Structure 


Initializatio n  CSU 

The  Initialization  CSU  contains  code  for  initializing  the  State  Display. 


stateRepIenishFreeList 

This  function  preallocates  storage  for  interrupt  routine  use  because  interrupt  routines  cannot 
allocate  memory.  The  function  call  is  void  stateReplenishFreeList(). 


1  Calls  1 

Function 

Where  Described 

OisablePeriodicO 

radmon.c 

stateAllocate 

This  function  allocates  a  state_vector  entry.  The  function  call  is  STATE?  stateAllocate(). 
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state_init 

state_init  initializes  state  things.  The  function  call  is  void  state_init(). 


1  Calls  1 

Function 

Where  Described 

htlnitfsize.  key) 

hTable.c 

stateReplenishFreeListO 

state.c 

state_close_callback 

state_close_callback  activates  the  callback  for  the  close  button  on  the  state  display  and  removes 
the  state  display  from  the  screen.  The  function  call  is  void  state_close_callback(). 


stateRegisterNames 

stateRegisterNames  registers  names  for  Mrm.  The  function  call  is  void  stateRegisterNames(). 


statelnitWidgets 

statelnitWidgets  gets  widget  ids  for  various  state  widgets.  The  function  call  is  void 
statelnitWidgetsQ. 


1  Calls  1 

Function 

Where  Described 

NameToWidqet(Darent,  name) 

disDiav.c 

Drawing  CSV 

state_draw_s_coin 

state_draw_s_com  draws  an  S_COM  (state  component).  This  is  basically  a  string.  The 
com_max  argiunent  gives  width  information  to  achieve  a  columnar  format.  The  Action  call  is 
void  state_draw_s_com(d,  w,  xp,  y,  com,  com_max,  left  Justify). 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

d 

See  Appendix. 
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w 

Window 

See  Appendix. 

xp 

pointer  to  Position 

See  Appendix. 

y 

Position 

See  Appendix. 

com 

S  COM 

See  Appendix. 

com  max 

S  COM 

See  Appendix. 

Boolean 

See  Appendix. 

state_draw_one_coin 

state_draw_one_com  draws  one  line  of  the  state  display,  rc  and  dc  give  the  S_COMs  to  be 
drawn.  The  function  call  is  void  state_draw_one_com(d,  w,  y,  rc,  dc). 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

d 

pointer  to  Display 

See  Appendix. 

w 

Window 

See  Appendix. 

V 

Position 

See  Appendix. 

rc 

RADIO  COMP 

See  Appendix. 

dc 

DERIVED  COMP 

See  Appendix. 

1  Calls  1 

Function 

Where  Described 

state_draw_s_com(d,  w,  sp,  y,  com,  com_max, 
left  iustifv) 

state.c 

state_  expose_caIlback 

state_expose_callback  exposes  the  callback  for  the  state  display  and  loops  through  all  states, 
drawing  the  distinct  ones.  The  function  call  is  void  state_expose_callback(). 


1  Calls  1 

Function 

Where  Described 

state.c 

state_clear_dci 

staie_clear_dci  clears  the  st_dci  field  of  all  states.  The  function  call  is  void  state_clear_dci(). 

Display /Layout  CSV 
state  new  radio  buttons 
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state_new_radio_buttons  creates  new  radio  buttons.  The  function  call  is  void 
state_new_radio_buttons(). 


1  calls  1 

Function 

Where  Described 

radio  name(rp) 

radmon.c 

state_create_widget 

state_create_widget  creates  a  new  state  widget  The  function  call  is  void  state_create_widget(). 


1  Calls  1 

Function 

Where  Described 

NameToWidaettDarent.  name) 

disDiav.c 

state_forniat_status 

state_fonnat_status  formats  the  "status,"  "from,"  and  "at"  fields  for  a  state.  The  function  call  is 
void  state_format_status(st,  sc). 


1  Parameters  1 

Parameter 

Tvoe 

Where  Typedef  Declared 

St 

See  Appendix. 

sc 

STATE  COMP 

See  Appendix. 

1  Calls  1 

Function 

Where  Described 

state  finish  comfcm.  max  cm.  s) 

state.c 

state  radio  namefst) 

state.c 

state_format_tuning 

state_format_tuning  formats  the  tuning  and  TOD  fields  of  the  state  display.  The  function  call 
is  state_format_tuning(tune,  sc). 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

tune 

TUNEP 

See  Appendix. 

sc 

STATE  COMP 

See  Appendix. 
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1  Calls  1 

Function 

Where  Described 

state  finish  comfcm,  max  cm.  s) 

state.c 

state_format 

state_fonnat  fonnat  the  fields  of  a  state.  The  function  call  is  state_fonnat(sc). 


1  Calls  1 

Function 

Where  Described 

state  finish  comfcm.  max  cm.  s) 

state.c 

state  format  tuninaftune.  set 

state.c 

state  format  statusfst.  sc) 

state.c 

state_format_statistics 

state_fonnat_statistics  formats  the  statistics  components  of  the  state  line.  The  function  call  is 
int  state_format_statistics(dc,  n,  overall.time). 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

dc 

DERIVED  COMP 

See  Appendix. 

n 

int 

See  Appendix. 

overall  time 

MSEC 

See  Appendix. 

1  Return  Values  I 

Return  Value 

n  distinct 

int 

.  I 

1  calls  1 

Function 

Where  Described 

state  is  distinct(stl .  st2) 

state.c 

state  finish  com(cm.  max  cm.  s) 

state.c 

state_display 

state_display  computes  a  new  state  display.  Hie  function  call  is  void  state_display(force). 
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state_function 

state.function  activates  the  callback  for  the  state  button  and  generates  the  state  display.  The 
function  call  is  void  state_functionO. 


state_update 

state.update  updates  the  state  display  because  itew  states  or  new  radios  exist.  The  function  call 
is  void  state.updateQ. 


I 

I 
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Selection  CSV 


state_attr_select 

state_attr_select  activates  the  callback  for  the  attribute  button  list  Certain  buttons  are  coupled 
together,  therefore,  selecting  certain  buttons  forces  other  buttons  to  be  selected  as  well,  and 
deselecting  certain  buttons  forces  other  buttons  to  be  deselected.  The  procedure  is: 

1 .  Build  a  mask  of  the  filter  bits  for  all  selected  buttons. 

2.  Compute  the  mask  of  buttons  which  became  unselected  (clr_bits). 

3 .  Compute  the  mask  of  buttons  which  became  selected  (set_bits). 

4.  Compute  the  mask  of  buttons  which  should  also  be  selected  by  or’ing  together  the 
set_coupled_bits  for  the  newly  selected  buttons. 

5 .  Similarly,  compute  the  mask  of  buttons  which  should  also  be  unselected  by  or'ing 
together  the  clr_coupled_bits  for  the  newly  deselected  buttons. 

6.  Augment  clr_bits  by  the  also_clr  bits  and  augment  set_bits  by  the  also_set  bits. 

7 .  Remove  any  bits  being  cleared  from  the  bits  being  set 

8 .  Change  the  selection  state  of  the  buttons  which  are  also.clr  and  also.set 

9 .  Remove  the  clr_bits  from  state_filter  and  add  set_bits. 

The  function  call  is  void  state_attr_selea(w,  a,  cback). 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

w 

Widaet 

See  Appendix. 

a 

caddr  t 

See  Appendix. 

cback 

pointer  to 

XmButtonLCallbackStruct 

See  Appendix. 

1  Calls  1 

Function 

Where  Described 

state  disolav(force) 

state.c 
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state_status_select 

state_status_select  activates  the  callback  for  the  status  selection  buttons  and  computes  the  new 
state_status_filter  from  the  selected  buttons.  The  function  call  is  void  state_status_select(w,  a, 
cback). 


1  Parameters  1 

Parameter 

Type 

Where  Tvpedef  Declared 

w 

Widoet 

See  Appendix. 

a 

caddr  t 

See  Appendix. 

cback 

pointer  to 

XmButtonLCallbackStmct 

See  Appendix. 

1  Calls  1 

Function 

Where  Described 

state  displav(force) 

state.c 

state_radio_seIect 

state_radio_select  changes  for  which  radios  the  state  display  is  generated,  state.display  tests 
the  selected  status  of  the  radio  selection  buttons  directly,  so  this  function  only  calls 
state.display  to  regenerate  the  display  according  to  the  new  set  of  selected  r^os.  The 
function  call  is  void  state_radio_select(w,  a,  cback). 
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Processing  CSU 
state_fill_one_radio 

state_fill_one_radio  processes  the  states  of  one  radio  and  computes  the  derived  state 
information.  AH  the  states  the  ra^o  has  ever  been  in  are  examined.  The  first  time  a  state  is 
examined,  the  corresponding  derived  information  is  initialized  and  attached  to  the  state.  In  any 
case,  the  derived  information  is  accumulated  according  to  how  many  times  the  state  is  entered 
and  how  long  the  radio  is  in  that  state.  The  function  call  is  void  state_fill_one_raxlio(rc,  rp, 
state_now). 


1  Parameters  1 

Parameter 

Tvpe 

Where  Tvoedef  Declared 

rc 

RADIO  COMP 

See  Appendix. 

rp 

RadioInfoP 

See  Appendix. 

state  now 

MSEC 

See  Appendix. 

1  Calls  i 

Function 

Where  Described 

state  expand  derived  com(rc.  n) 

state.c 

state_coinpiIe_statistics 

state_compile_statistics  formats  the  statistics  fm-  a  radio  (or  radios),  computes  the  radio 
field,  and  returns  the  number  of  distinct  states.  The  function  call  is  int 
state_compile_statistics(rc,  total_time). 
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state__com_compare 

statB_coni_compare  coitq)aies  two  RADIO_COMPs  for  sorting.  The  function  call  is  int 
state_radio_com_compare(rcl,  rc2). 


1  Parameters  1 

Parameter 

Tvoe 

Where  Typedef  Declared 

rc1.  rc2 

RADIO  COMP 

See  Appendix. 

I  Return  Values  I 

Return  Value 

Type 

-1 

int 

1 

int 

0 

int 

state_derived_com_compare 

state_derived_com_compare  compares  two  DERTVED^COMs  for  sorting.  The  function  call  is 
int  state_derived_com_compare(dcl,  dc2). 


state_is_distinct 

state_is_distinct  tests  whether  two  states  are  distinct  given  the  current  state_filter.  The  function 
call  is  Boolean  state_is_distinct(stl,  st2). 
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1  Parameters  1 

Parameter 

Where  Tvpedef  Declared 

St1 ,St2 

STATEP 

See  Appendix. 

I  Return  Values  I 

Return  Value 

False 

Boolean 

True 

Boolean 

state_expand_state_comp 

state_expand_state_comp  increases  the  size  of  the  state_state_comp  vector  to  accommodate 
more  states.  TTie  function  call  is  void  state_expand_state_comp(n). 


I  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

n 

int 

See  Apoendix. 

state_expand_^derived_coni 

state_expand_derived_com  increases  the  size  of  a  DERrVED_COM  vector.  The  function  call  is 
void  state_expand_derived_com(rc,  n). 


I  Parameters  I 

Parameter 

Type 

Where  Tvpedef  Declared 

rc 

RADIO  COMP 

See  Appendix. 

n 

int 

See  Appendix. 

state_expand_radio_coin 

state_expand_radio_com  increases  the  size  of  the  state_radio_com  vector.  The  function  call  is 
void  state_expand_radio_com(n_radios). 


Parameter 

n  radios 


int 


Parametera 


Where  Typedef  Declared 
See  Appendix. _ 
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Storage  CSV 
state_nnish_com 

state_finish_com  stores  a  string  as  the  value  of  an  S_CX)M.  It  reallocates  the  space  for  the 
value  if  necessary  and  updates  die  maximum  width  in  max_cm  as  needed.  The  function  call  is 
void  state_finish_com(cm,  max_cm,  s). 


1  Parameters  1 

Parameter 

Tvoe 

Where  Tvpedef  Declared 

cm 

reaisterS  COMP 

See  Appendix. 

max  cm 

S  COMP 

See  Appendix. 

s 

pointer  to  char 

See  Appendix. 

state_destroy 

state.destray  releases  state  related  storage.  The  function  call  is  void  state.destroyQ. 


1  Calls  1 

Function 

Where  Described 

htlnitfsize,  key) 

hTabio.c 

htFree(ht') 

hTable.c 

stateReplenishFreeListO 

hTable.c 

I 

State  Manipulation  CSV 

state_count_fiIe  | 

state_count_file  counts  how  many  lines  of  output  will  be  written  for  the  state  sectitxi  of  a 

radrrmn  file.  The  function  call  is  int  state_count_file().  ■ 


1  Return  Values  I 

Return  Value 

state  n  vector-t-l 

int 

1 

state_write_flle 

state_write_file  writes  the  state  section  of  a  radmon  file.  The  function  call  is  void 
state_write_file(f). 


96 


BBN  Systems  and  Technologies 


BBN  Report  No.  7628 


state_read_file 

state_read_file  reads  the  state  section  of  a  radmon  file.  The  function  call  is  char 
*state_read_file(f,  version). 


state_find 

state_find  finds  the  state  vector  entry  for  the  given  state.  If  the  state  is  not  found,  an  entry  is 
made.  The  function  call  is  STATEP  state_find(st). 


1  Parameters  I 

Parameter  jType 

Where  Typedef  Declared 

St  1  STATEP 

See  Appendix. 

No.  7628 


Return  Value 


value 


Function 


htlnsertlht,  name,  value 


htFincKht.  name,  value 


stateAllocate 
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Return  Values 


STATEP 


Calls 


Where  Described 


hTable.c 


hTable.c 


state.c 


state_nth 

state_nth  returns  the  nth  state  from  the  state.vector.  The  function  call  is  STATEP  state_nth(n). 


Parameters 


Parameter 


n 


Where  Tvpedef  Declared 


state.c 


Return  Values 


Return  Value 


state,  vecto 


array  of  STATEP 


3.2.4  Utilities  CSC 

The  Utilities  CSC  provides  utilities  used  by  the  other  CSCs.  It  is  comprised  of  three  CSUs,  as 
shown  in  Figure  3-2.4- 1. 
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Utilities 

CSC 


hTable 

Timeline 

Tune 


Figure  3<2.4<1.  Utilities  CSC  Structure 


hTable  CSV 

The  hTable  CSU  consists  of  hash  table  routines. 


htReplenish 

htReplenish  replenishes  storage  for  hashentiies.  htinsert  may  be  called  from  interrupt  level  and 
is  not  allowed  to  allocate  memory.  We  pieallocate  here  and  keep  the  entries  on  a  frro  list  The 
function  call  is  void  htReplenishQ. 


htFreelnit 

htFreelnit  initializes  the  fire  list  and  counts  and  does  the  initial  replenishnnent  The  function  call 
is  void  htFrecInitO. 


1  Calls  1 

Function 

Where  Described 

htReolenish 

hTable.c 

bashO 

hash()  computes  a  hash  index  from  the  key.  It  combines  the  bytes  making  up  the  key  into  an 
integer  index  into  the  hash  table.  The  function  call  is  int  hashfname,  ht). 
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1  Return  Values  1 

Return  Value 

-n 

int 

n 

int 

htInitO 

htlnit(  initializes  a  hash  table  and  creates  a  hash  table  of  the  specified  size  and  key  size.  The 
function  call  is  HTABLEP  htlnit(size,  key). 


1  Parameters  1 

Parameter 

Tvoe 

Where  Tvoedef  Declared 

size 

iht 

See  Apoendix. 

key 

int 

See  Appendix. 

1  Return  Values  1 

Return  Value 

■■■■■■■■■■■■ill 

ht 

HTABLEP 

htFree 

htFree  releases  hash  table  storage.  The  funcdon  call  is  void  htFree(ht). 


htinsert 

htinsert  inserts  an  entry  in  the  hash  table.  It  searches  for  an  existing  entry  matching  the  key.  If 
found,  its  value  is  changed;  otherwise,  a  new  entry  is  created  and  chained  onto  the  list  for  the 
proper  bucket  In  either  case,  the  HASHENTRY  is  returned.  The  function  call  is 
HASHENTRYP  htlnsert(ht,  name,  value). 


1  Parameters  1 

Parameter 

Type 

Where  Tvoedef  Declared 

ht 

HTABLEP 

See  Apoendix. 

name 

pointer  to  char 

See  Apoendix. 

value 

int 

See  Apoendix. 

Return  Value 


i  Tyoe 


Return  Values 


HASHENTRYP 
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Calls 

Function  [Where  Described 

hash(name.  ht)  1  hTable.c 


htFind 

htFind  searches  the  hash  table  for  the  specified  key  and  returns  the  HASHENTRY  found.  It 
returns  NULL  if  the  entry  cannot  be  found.  The  Kmction  call  is  HASHENTRYP  htFind(ht, 
name,  value). 


1  Parameters  1 

Parameter 

Where  Tvoedef  Declared 

ht 

HTABLEP 

See  Appendix. 

name 

Dointertochar 

See  Appendix. 

value 

int 

See  Appendix. 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

p 

HASHENTRYP 

null 

HASHENTRYP 

Name  not  found,  return  failure. 

1  Calls  1 

Function 

Where  Described 

hashfname,  ht) 

hTable.c 

I 

Timeline  CSV 

I  The  limeline  CSU  consists  of  routines  for  manipulating  timelines. 


tIEnqueue 

tlEnqueue  adds  a  segment  to  the  indicated  queue.  The  function  call  is  tl£nqueue(tlq,  tls). 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

tlQ 

TLQP 

See  Appendix. 

tls 

TLSP 

See  Appendix. 
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tlDequeue 

tlDequeue  reixioves  a  segment  from  the  indicated  queue.  The  function  call  is  TLSP 
tlDequeue(tlq). 


1  Parameters  1 

Parameter 

Tvoe 

Where  Tvoedef  Declared 

i!a _ 

TLQP 

See  Apoendix. 

1  Return  Values  1 

Return  Value 

tis 

TLSP 

1 

tIReplenishFreeList 

tlReplenishFteeList  replenishes  the  free  list  Interrupt  level  routines  can't  allocate  memory,  so 
we  keep  a  list  of  available  segments  to  be  used  at  interrupt  level.  The  function  call  is  void 
tlReplenishFreeListQ. 


Cal 

Is 

Function 

Where  Described 

tiEnaueuedlq.  tIs) 

timeline.c 

DisablePeriodicO 

radmon.c 

tllnit 

tUnit  initializes  timeline  things.  The  function  call  is  void  tUnitQ. 


1  Calls  1 

Function 

Where  Described 

tlReplenishFreeListf) 

timeline.c 
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tIChangeState 

tlChangeState  adds  a  new  state  transition  to  a  radio.  If  the  current  segment  is  full,  another  is 
allocated.  The  function  call  is  void  tlChangeState(rp,  timestamp). 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

rp 

RadioInfoP 

See  Appendix. 

timestamp 

MSEC 

See  Appendix. 

1  Calls  1 

Function 

Where  Described 

tIEnqueue 

timeline.c 

tiOeaueue 

timeline.c 

\ 


tlNext 

tlNext  advances  the  given  segment  and  element  pointers  to  the  next  element  It  returns  false  if 
there  arc  no  more.  The  function  call  is  Boolean  tiNextftlsp,  tlep). 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

tisp 

pointer  to  TLSP 

See  Appendix. 

tlep 

pointer  to  TLEP 

See  Appendix. 

1  Return  Values  1 

Return  Value 

Type 

Meanina 

False 

Boolean 

No  more  elements 

True 

Boolean 

Advances  segment  and 
element  pointer  to  next 
element. 

tlPrev 

tlPrev  steps  the  given  segment  and  element  pointers  to  the  previous  element  The  function  call 
is  Boolean  tlPrev(tlsp,  tlep). 


1  Parameters  1 

Parameter 

Typo 

Where  Typedef  Declared 

tIsp 

pointer  to  TLSP 

See  Appendix. 

tlep 

pointer  to  TLEP 

See  Appendix. 
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tlFind 

tlFind  finds  the  element  which  embraces  the  given  time  and  returns  its  segment  and  element 
pointers.  Returns  False  if  there  is  no  such  element  The  function  call  is  Boolean  tlFind(rp, 
when,  tlsp,  tlep). 


Parameter 


Parameters 


inter  to  TLSP 


inter  to  TLEP 


Where  Tvoedef  Declared 


See  ADoendix. 


See  ADoendix. 


See  Apoendix. 


See-Aopendix. 


Return  Value 


True 


Return  Values 


Boolean 


Boolean 


Meanin 


Time  element  segment  and 
element  pointers 


No  such  eiement 


tlReadFile 

tlReadFile  reads  a  timeline  portion  of  a  radmon  file.  The  functitm  caU  is  char  ’^tlReadHleff, 
rp). 
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Function 


tlEnqueue(tlq,  tis 


tlDequeueitl 


tlHeolenishFreeList 


state  nth(n 


tlCountFHe 


Calls 


where  Described 


timeline.c 


timeline. c 


timeline.c 


file.c 


state.c 


UCountHle  counts  haow  many  lines  are  required  to  write  a  timeline.  The  function  call  is  int 
tlCountFile(rp). 


tlWriteFile 

tlWriteFile  writes  a  timeline  portion  of  a  radmon  file.  The  function  call  is  void  tlWriteFile(f, 
rp). 


Parameters 


Parameter 


Radio  InfoP 


inter  to  FILE 


where  Tvoedef  Declared 


See  Appendix 


See  Appendix. 


Function 


file  countfn 


Calls 


Where  Described 


file.c 


tIFree 

tlFree  releases  timeline  information  for  a  radio.  The  function  call  is  void  tlFree(rp). 
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1  Calls  1 

Function 

Where  Described 

tlEnqueueftlq,  tis) 

timeiine.c 

tlOequeue(tlq) 

timeline.c 

Tune  CSV 

The  Tune  CSU  consists  of  routines  to  keep  track  of  timings. 


tune_count__file 

tune_count_file  counts  the  number  of  output  lines  fen*  the  tuning  section  of  a  radmon  file.  The 
function  call  is  int  tune_count_file(). 


1  Return  Values  I 

Return  Value 

Tvoe 

Meanlnq 

tune_njist+  1 

int 

Number  of  output  lines  for 
tuninq  section  of  a  radmon  file. 

tune_write_file 

tune_write_file  writes  the  tuning  section  of  a  radmon  file.  The  function  call  is  void 
tune_write_file(f). 


1  Parameters  I 

Parameter 

Tvoe 

Where  Typedef  Declared 

f 

pointer  to  FILE 

See  Appendix. 

Calls 

Function 

1  Where  Described 

file  count(n)  I  file.c 
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tune_read_nie 

tune_read_file  reads  the  tuning  section  of  a  radmon  file.  The  function  call  is  char 
*tune_read_file(f,  version). 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

f 

pointer  to  FILE 

See  Appendix. 

version 

int 

See  Appendix. 

1  Return  Values  1 

Return  Value 

Typo 

Meanlna 

'Premature  EOF  while  reading 
%s 

char 

Error  message 

"File  %s  has  bad  format* 

char 

Error  messaae 

NULL 

No  error 

1  Calls  1 

Function 

Where  Described 

htReplenishO 

hTable.c 

tuneRepienishFreeListO 

tune.c 

tune  find  mode,  freauencv.  hopinfo) 

tune.c 

file  aetsfbud.  size,  f) 

file.c 

tuneRepIenishFreeList 

tuneReplenishFieeList  replenishes  the  list  of  free  tunings.  We  preallocate  tunings  and  keep 
them  in  a  list  so  interrupt  level  code  doesn't  have  to  allocate  storage.  The  function  call  is  void 
tuneReplenishFrecListO. 


1  Calls  1 

Function 

Where  Described 

DisablePeriodicO 

radmon.c 

tuneAIIocate 

tuneAUocate  gets  a  tuning  from  the  fitee  list  The  function  call  is  TUNEP  tuneAllocate(). 
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tune  init 


tune.init  initializes  tuning  stuff  and  performs  initial  replenishment  The  function  call  is  void 
tune_init(). 


Function 


htinitlsize.  ke 


tuneReoienishFreeList 


tune  set  name 


Calls 


Where  Described 


hTable.c 


tune.c 


tune_set_name  sets  the  q_name  of  a  tuning  from  the  frequency  or  hopset  id.  We  do  this  once 
when  the  tuning  is  created  so  the  name  is  readily  available.  The  function  call  is  void 
tune_set_name(tunel).  . 


Parameters 


Parameter 


tunei 


tune  find 


TUNEP 


Where  Tvoedef  Declared 


See  Appendix. 


tune.find  finds  a  tuning  for  the  given  mode  and  frequency  or  hopinfo.  If  the  tuning  does  not 
already  exist  it  is  creat^  The  function  call  is  TUNEP  tune_f!nd(nKxle,  freqiency,  hopinfo). 


Parameters 


Parameter 


mode 


hopinfo 


Return  Value 


value 


inter  to  FHParameters 


Where  Tvoedef  Declared 


See  Appendix. 


See  Appendix. 


See  Appendix. 


Return  Values 


TUNEP 
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1  Calls  1 

Function 

Where  Described 

tune  set  name(tunel) 

tune.c 

htlnsert(ht,  name,  value) 

hTable.c 

htFind(ht,  name,  value) 

hTable.c 

tuneAllocateO 

tune.c 

tune_new 

tune.new  is  called  when  new  tunings  have  been  created  to  update  the  tune_list  and  create 
tuning  buttons  for  the  traffic  display.  The  function  call  is  void  tune_new(). 


Calls 


Function 

Where  Described 

traffic  new  tune(tune) 

traffic.c 

tune_compare 

tune_compaie  compares  two  tunings.  It  is  used  by  the  state  display  to  sort  states.  The 
function  call  is  int  tune_compare(tl,  t2). 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

11 

TUNEP 

See  Appendix. 

t2 

TUNEP 

See  Appendix. 

Return  Values 

Return  Value  I  Type  I  Meaning 
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I 

t 


tune_destroy 

tune_destroy  releases  tuning  storage.  The  function  call  is  void  tune_desttoyO. 


1  Calls  1 

Function 

Where  Described 

htlnit(size,  kev) 

hTable.c 

htFree(ht) 

hTable.c 
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Appendix: 

Radio  Performance  Monitor  (RADMON)  CSCI 
Typedef  Reference 


Table  of  Contents 

display. c . 112 

me.c . 114 

hTable.c . 116 

map.c . 117 

net.c . 122 

radmon.c . 124 

state. c . 126 

status.c . 130 

timeline. c . 132 

traffic.c . 134 

tune.c . 141 

version.c . 142 

hTable.h . 142 

radmon.h . 142 

state.h . 142 

style.h . 142 

timeline.h . 142 

traffic. h . 142 

tune.h . 142 
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FILE:  displays 

FUNCTION:  quit_callback(w) 

parameter  Widget  w,  defined  in  <X1 1/Intrinsic.h> 

FUNCTION:  dump_callback(w) 

parameter  Widget  w,  defined  in  <X1  l/IntTmsic.h> 

FUNCTION:  tesct_callback(w) 

parameter  Widget  w,  defined  in  <X1 1/Intrinsic.h> 

FUNCTION:  function_descend(fbc,  fh) 

parameter  FUNCnON_BUTTON_CLOSUREP  fbc,  defined  in  radmon.h 
parameter  void  (*fii)0.  standard  type 
FUNCTION:  display.deselectQ 
FUNCTION:  function_callback(w,  fbc,  cback) 

parameter  Widget  w,  defined  in  <X1 1/Intrinsic.h> 
parameter  FUNCnON_BUTTON_CLOSUREP  fbc,  defined  in  radmon.h 
parameter  XmButtonLCallbackStnict  *cback 
FUNCTION:  create_function_items<w,  fbc) 

parameter  Widget  w,  defined  in  <X1 1/Intrinsic.h> 
parameter  FUNCnON.BUTTON.CLOSUREP  fbc,  defined  in  radmon.h 
FUNCTION:  clipResizefw,  data,  cback) 

parameter  Widget  w,  defined  in  <X1 1/Intrinsic.h> 
parameter  caddr.t  data,  defined  in  <sys/types.h> 
parameter  XmAnyCailbackStruct,  standard  type 
FUNCTION:  NameToWidgetCparent,  name) 

parameter  Widget  parent,  defined  in  <X1 1/Intrinsic.h> 
parameter  char  *name,  standard  type 
FUNCTION:  CvtStringToWidgct(args,  nargs,  fromVal,  toVal) 
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parameter;  XrmValuePtr  args,  ftomVal,  toVal,  defined  in  <X1  l/Xrcsource.h> 
parameter  int  *nargs,  standard  type 
FUNCTION:  CvtStringToXmStringLtoR(args,  nargs,  ftomVal,  toVal) 

parameter:  XrmValuePtr  args,  fromVal,  toVal,  defined  in  <Xll/Xresource.h> 
parameter  int  *nargs,  standard  type 
FUNCTION:  CvtStringToColor(args,  nargs,  fromVal,  toVal) 

parameter:  XrmValuePtr  args,  fromVal,  toVal,  defined  in  <X1  l/Xresource.h> 
parameter  int  *nargs,  standard  type 
FUNCTION:  display_init(argq),  argv) 
parameter  int  *atgcp,  standard  type 
parameter  char  *argv[],  standard  type 
FUNCTION:  Dispatchf) 
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FILE:  file.c 

FUNCTION:  file_ok(w,  data,  cback) 

parameter:  Widget  w,  defined  in  <X1 1/Intrinsic.h> 
parameter  caddr.t  data,  defined  in  <sys/types.h> 

parameter!  XmSelectionBoxCallbackStmct  *cback,  defined  in  <Xm/Xm.h> 
FUNCTION:  file_popup(w) 

parameter!  Widget  w,  defined  in  <X1 1/Intrinsic.h> 

FUNCTION:  file_error(fmt,  arg) 
parameter:  char  *£mt,  standard  type 
parameter  char  ’"arg,  standard  type 
FUNCTION:  file.flushO 
FUNCTION:  file_infoim(ftnt,  arg,  maximum) 
parameter  char  *fint,  standard  type 
parameter  char  “"arg,  standard  type 
parameter  int  maximum,  standard  type 
FUNCTION:  file_inform_end() 

FUNCTION;  file_gets(buf,  size,  f) 
parameter  char  *buf,  standard  type 
parameter  int  size,  standard  type 
parameter  FILE  ’"f,  defined  in  <stdio.h> 

FUNCTION:  file_count(n) 

parameter  int  n,  standard  type 
FUNCTION:  file_write_file(filename) 
parameter  char  ’"filename,  standard  type 
FUNCTION:  file.wrileO 
FUNCTION:  file_read_file(filename) 


parameter  char  "'filename,  standard  type 
FUNCTION:  file.readQ 
FUNCTION:  fileRegisterNamesO 
FUNCnON:  filelnitWidgetsO 
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FILE:  hTable.c 

FUNCTION:  htReplenishO 
FUNCTION:  htFreelnitO 
FUNCTION:  hash(name,  ht) 

parameter  char  *1131116,  standard  type 
parameter  HTABLEP  ht,  defined  in  hTable.h 
FUNCTION:  htlnit(size,  key) 
parameter  int  size,  standard  type 
parameter  int  key,  standard  type 
FUNCTION:  htRree(ht) 

parameter  HTABLEP  ht,  defined  in  hTable.h 
FUNCTION:  htlnsertfht,  name,  value) 

parameter  HTABLEP  ht,  defined  in  hTab2e.h 
parameter  char  *name,  standard  type 
parameter  int  value,  standard  type 
FUNCTION:  htFindfht,  name,  value) 

parameter  HTABLEP  ht,  defined  in  hTable.h 

parameter  char  *name,  standard  ^pe 

parameter  hash_value_type  *value,  defined  in  hTableJi 
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FILE:  mapx 

FUNCTION:  ForegroundColorDefault(widget,  offset,  valPtr) 
parameter  Widget  widget,  defined  in  <X1 1/Intrinsic.h> 
parameter  int  offset,  standard  type 

parameter  XrmValuePtr  valPtr,  defined  in  <X1  l/Xresouice.h> 
FUNCTION:  BackgroundColorDefault(widget,  offset,  valPtr) 
parameter  Widget  widget,  defined  in  <X1 1/Intrinsic.h> 
parameter  int  offset,  standard  type 

parameter  XrmValuePtr  valPtr,  defined  in  <X1  l/Xiesource.h> 
FUNCTION:  CvtStringToMapStyle(args,  nargs,  from,  to) 
parameter:  XimValue  *args,  defir^d  in  <Xll/Xresouice.h> 
parameter  int  *nargs,  standard  type 
parameter:  XrmValue  *from,  defined  in  <Xll/Xresource.h> 
parameter  XimValue  ’"to,  defined  in  <Xll/Xresource.h> 
FUNCTION:  map_select(w,  a,  cback) 

parameter  Widget  w,  defined  in  <X1 1/Intrinsic.h> 
parameter  caddr_t  a,  defined  in  <sys/types.h> 
parameter  XmListCallbackStruct  ’"cback,  defined  in  <Xm/Xm.h> 
FUNCTION:  map_time_callback(w,  a,  cback) 

parameter  Widget  w,  defined  in  <X1 1/Intrinsic.h> 
parameter:  caddr_t  a,  defined  in  <sys/types.h> 
parameter  XmAnyCallbackStruct  ’"cback,  defined  in  <XnVXm.h> 
FUNCTION:  iiMq)_color_animaieO 
FUNCTION:  map_style_of_type(type) 

parameter  unsigned  char  type,  standard  type 
FUNCTION:  map_shape_of_types(typel,  type2) 
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parameten  unsigned  char  typel,  type2,  standard  type 
FUNCTION:  map_gc_of_type(type,  lesser_typc,  gcpl,  gcp2) 
parameten  unsigned  char  type,  standard  type 
parameten  unsigned  char  lesser_type,  standard  type 
parameten  GC  *gcpl,  *gcp2,  defined  in  <X11/Xlib.h> 

FUNCTION:  map_bounding_box(pts,  npts) 

parameten  register  XPoint  *pts,  defined  in  <X1 1/Xlib.h> 
parameten  int  npts,  standard  type 

FUNCTION:  map_draw_bolt(dpy,  wind,  rpl,  rp2,  typel,  type2,  shape,  mode) 
parameter.  Display  *dpy,  defined  in  <X11/Xlib.h> 
parameten  Window  wind,  defined  in  <X1 1/X.h> 
parameten  RadioInfoP  rpl,  rp2,  defined  in  radmon.h 
parameten  unsigned  char  typel,  Qrpe2,  standard  type 
parameter:  unsigned  char  shape,  standard  type 
parameten  DRAW.MODE  mode,  defined  in  this  file 
FUNCTION:  map_resct_pcnding_drawO 
FUNCTION:  map_drawO 
FUNCTION:  map_start_draw() 

FUNCTION:  map_eraseO 
FUNCTION:  map_start_erase() 

FUNCTION:  map_color_radio(rp) 

parameter:  RadioInfoP  rp,  defined  in  radmon.h 
FUNCTION:  mq)_color_vehicle(vp) 

parameten  VehicleInfoP  vp,  defined  in  radm(m.h 
FUNCTION:  map_display_move(  visible,  x,  y) 
parameten  Boolean  visible,  defined  in  radmon.h 
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parameter:  Position  x,  y,  defined  in  <X1 1/Intrinsic.h> 

FUNCTION:  map_input(w,  vp,  event) 

parameter  Widget  w,  defined  in  <X1 1/Intrinsic.h> 
parameter  VehicleInfoP  vp,  defined  in  radmon.h 
parameter  XEvent  *event,  defined  in  <X1 1/Xlib.h> 

FUNCTION:  map_expose(w,  a,  cback) 

parameter  Widget  w,  defined  in  <X1 1/Intrinsic.h> 
parameter:  caddr.t  a,  defined  in  <sys/types.h> 

paranwter  XmDrawingAieaCallbackStruct  *cback,  defined  in  <Xm/Xm.h> 
FUNCTION:  map_resize(w) 

parameter  Widget  w,  defined  in  <X1 1/Intrinsic.h> 

FUNCTION:  map_closeO 
FUNCTION:  map_stepO 
FUNCTION:  map_step_to_anomaly0 
FUNCTION:  map_fieezeO 
FUNCTION:  map_unfteezeO 
FUNCTION:  mapRegisterNamesO 
FUNCTION:  mapInitWidgetsO 
FUNCTION:  map_aIIocatB_colorsO 
FUNCTION:  map_animati(Mi_pixmap(dir,  rootwindow) 
parameter  int  dir,  standard  type 
parameter  Window  rootwindow,  defined  in  <X1 1/X.h> 

FUNCTION:  map_create_widgctO 
FUNCTION:  map_creaie_vehicle_widget(vp) 
parameter  VehicleInfoP  vp,  (kfined  in  radmon.h 
FUNCTION:  m^_remanage_vehicle(vp) 
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parameter  VehicleInfoP  vp,  defined  in  radmon.h 
FUNCTION:  map_layoutL.compaie_x(vppl,  vpp2) 

parameter:  VehicleInfoP  *vppl,  *vpp2,  defined  in  radmon.h 
FUNCTION:  nM^_layout_coinpare_y(vppl,  vpp2) 

parameter  VehicleInfoP  *vppl,  *vpp2,  defined  in  radmon.h 
FUNCTION:  map_measure() 

FUNCTION:  map_layoutO 
FUNCTION:  map_create_radio_buttonsO 
FUNCTION:  map_displayO 
FUNCTION:  map_set_time(t) 

parameter  MSEC  t,  defined  in  timeline.h 
FUNCTION:  map_rccolotO 
FUNCTION:  mt^.updateO 

FUNCTION:  map_set_c(Mmectivity(rpl,  idx,  new_connectivity) 
parameter  RadioInfoP  ipl,  defined  in  radmon.h 
parameter:  int  idx,  standard  type 
parameter  unsigned  char  new.connectivity,  standard  type 
FUNCTION:  map_vehicle_nioved(vp) 

parameter  VehicleInfoP  vp,  defined  in  radmon.h 
FUNCTION:  map_moie_radiosO 
FUNCTION:  map_vehicle_vanished(vpl) 

parameter:  VehicleInfoP  vpl,  defined  in  radmon-h 
FUNCTION:  map_vehicle_appeared(vpl) 

parameter:  VehicleInfoP  vpl,  defined  in  radmon.h 
FUNCTION:  mapJnit_radio(rp) 

paraiTOter:  RadioInfoP  rp,  defined  in  radmon.h 

I 
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FUNCTION:  map_rcsetO 
FUNCTION:  inap_radio_transmit_time(rp,  when) 
paraoMter:  RadioInfoP  ip,  deHned  in  radmon.h 
parameter  MSEC  when,  defined  in  timeline.h 
FUNCTION:  map_set_radio_time(rp,  when) 
parameter:  RadioInfoP  rp,  defined  in  radmon.h 
parameter  MSEC  when,  defined  in  timeline.h 
FUNCTION:  map_advance(up_to,  advance_mode,  max_advance) 
parameter  MSEC  up_to,  defined  in  timeline.h 
parameter  MAP_ADVANCE_MODE  advance_naode,  defined  in  this  file 
parameter  MSEC  max.advance,  defined  in  timeline.h 
FUNCTION:  map_advance_dispIay(up_to,  max_advance,  if_firozen) 
parameter:  MSEC  up_to,  defined  in  timeline.h 
parameter  MSEC  max.advance,  defined  in  timeline.h 
parameter:  Boolean  if.firozen,  defined  in  radmon.h 


FUNCTION:  map_destroyO 
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FILE:  net.c 

FUNCTION:  InitSimNctworkO 
FUNCTION:  net_dcstroyO 
FUNCTION:  VehicleIDtoIadex(vehicleID) 
parameter  VehiclelD  vehiclelD 
FUNCTION:  net_read_fUe(f,  version) 
parameter  FILE  defined  in  <stdio.h> 
parameter  int  version,  standard  type 
FUNCTION:  net_count_file(f) 

parameter  FILE  *f,  defined  in  <stdio.h> 

FUNCTION:  net_write_file(f) 

parameter  FILE  *f,  defined  in  <stdio.h> 

FUNCTION:  netReplenishO 
FUNCTION:  ReadPDUsO 
FUNCnON:  DrainPDUsQ 
FUNCTION:  netChangeState(rp,  st,  timestamp) 
parameter  RadioInfoP  rp,  defined  in  radmon.h 
parameter  STATEP  st,  defined  in  state.h 
FUNCTION:  nxx»ssVehicIeAppearancePDU(pdu,  timestamp) 
parameter  VehicleAppearanoeVariant  *pdu 
parameter  MSEC  timestanq),  defined  in  dmeline.h 
FUNCTION:  PtocessDeactivatePDU(pdu,  timestamp) 
param^er  DeactivateResponseVariant  *pdu 
parameter  MSEC  timestamp,  defined  in  timeline.h 
FUNCTION:  ProccssStatusChangePDUfpdu,  timestanop) 
parameter  StatusChangeVariant  "'pdu 
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parameter  MSEC  timestamp,  defiittd  in  timeline.h 
FUNCTION;  ProcessVehicleStatusPDU(pdu,  timestamp) 
parameter  VehicleStatusVariant  ’^'pdu 
parameter  MSEC  timestamp,  defined  in  timeline.h 
FUNCTION;  ProcessTransmitterPDU(pdu,  timestamp) 
parameter  register  TransmitterVariant  *pdu 
parameter  MSEC  timestamp,  defined  in  timeline.h 
FUNCTION;  ProcessReceiverPDU(pdu,  timestamp) 
parameter  register  ReceiverVariant  *pdu 
parameter  MSEC  timestamp,  defined  in  timeline.h 
FUNCTION;  net_geteaddrO 
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FILE:  radinon.c 

FUNCTION:  inain(argc,  argv) 
parameter  int  argc,  standard  type 
parameter  char  """argv,  standard  type 
FUNCTION:  slow_periodicO 
FUNCTION:  medium_periodic() 

FUNCTION:  EnablePetiodicO 
FUNCTION:  DisablePeriodicO 
FUNCTION:  fast.4)eriodic0 
FUNCTION:  resetTimeQ 
FUNCTION:  InitVehicle(vp,  vidx) 

parameter  VehicleInfoP  vp,  defined  in  radmon.h 
parameter  int  vidx,  standard  type 
FUNCTION:  DestroyEverythingO 
FUNCTION:  set_identification_labelO 
FUNCTION:  OfflineQ 
FUNCTION:  OnlineQ 
FUNCTION:  DestroyWidget(wp) 

parameter  Widget  *wp,  defined  in  <X1 1/Intrinsic.h> 
FUNCTION:  Destroy VehiclesO 
FUNCTION;  resetRadiosQ 
FUNCTION:  TlmeoutRadiosO 
FUNCTION:  HmeoutVehiciesO 
FUNCTION:  vehicle_name(vp) 

parameter  VehicleInfoP  vp,  defined  in  radmon.h 
FUNCTION:  radio_name(rp) 
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parameter!  RadioInfoP  rp,  defined  in  radmon.h 
FUNCTION:  state_nuiio_naine(st) 

parameter  STATEP  st,  defined  in  state.h 
FUNCTION:  exit_gracefully() 

FUNCTION:  print_bannerO 
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FILE:  state.c 

FUNCTION:  sateReplenishFreeListO 
FUNCTION:  stateAllocateO 
FUNCTION:  state.initO 
FUNCTION:  state_couiit_fileO 
FUNCTION:  state_write_file(0 

parameter  FILE  defined  in  <stdio.h> 

FUNCTION:  state_read_file(f,  version) 
parameter  FILE  defined  in  <stdio.li> 
parameter  int  version,  standard 
FUNCTION:  state_find(st) 

parameter  STATE?  st,  defined  in  state.h 
FUNCTION:  state^close.callbackO 
FUNCTION:  state_is_distinct(stl,  st2) 
paranKter  STATE?  stl,  defined  in  state.h 
parameter  STATE?  st2,  defined  in  st8te.h 
FUNCTION:  state_draw_s_com(d,  w,  xp,  y,  com,  com.max,  leftjustify) 
parameter  Display  *d,  defined  in  <X1 1/Xlib.h> 
parameter  Window  w,  defined  in  <X1 1/X.h> 
parameter  Fosition  *xp,  defined  in  <X1 1/Intrinsic.h> 
parameter  Position  y,  defined  in  <X1 1/Intrinsic.h> 
parameter  S.COM  com,  defined  in  state.h 
parameter  S_COM  com.max,  defined  in  state.h 
parameter  Boolean  leftjustify,  defined  in  radmon.h 
FUNCTION;  state_draw_one_com(d,  w,  y,  rc,  dc) 
parameter  Display  *d,  defined  in  <X1 1/Xlib.h> 
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parameter.  Window  w,  defined  in  <X1 1/X.h> 
parameter  Position  y,  defined  in  <X11/Intrinsic.h> 
parameter  RADIO_COMP  rc,  defined  in  state.h 
parameter  DERIVED_COMP  dc,  defined  in  state.h 
FUNCTION:  state_expose_callback() 

FUNCTION:  state_attr_select(w.  a,  cback) 

parameter  Widget  w,  defined  in  <X1  lAntrinsic.h> 
parameter:  caddr.t  a,  defined  in  <sys/types.h> 
parameter  XmButtonLCallbackStnict  *cback 
FUNCTION:  state_status_select(w,  a,  cback) 

parameter  Widget  w,  defined  in  <X1 1/Intrinsic.  h> 
parameter:  caddr_t  a,  defined  in  <sys/types.h> 
parameter  XmButtonLCallbackStruct  ♦cback 
FUNCTION:  state_radio_selcct(w,  a,  cback) 

parameter  Widget  w,  defined  in  <X1 1/Intrinsic.h> 
parameter:  caddr_t  a,  defined  in  <sys/types.h> 
parameter  XmButtonLCallbackStruct  ♦cback 
FUNCTION:  stateRegisterNamesO 
FUNCTION:  statelnitWidgetsO 
FUNCTION:  state_new_radio_buttons() 

FUNCTION:  state_create_widgetO 
FUNCTION:  state_finish_com(cm,  max_cm,  s) 
parameter  register  S_COMP  cm,  defined  in  state.h 
parameter  S.COMP  max_cm,  defined  in  state.h 
parameter  char  ♦s,  standard  type 
FUNCTION:  state_format_status(st,  sc) 
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parameten  STATEP  st,  defined  in  state.h 
parameter:  STATE_CX}MP  sc,  defined  in  state.h 
FUNCTION:  state_fonnat_tuning(tune,  sc) 
parameter:  TUNEP  tune,  defined  in  tune.h 
parameter:  STATE_COMP  sc,  defined  in  statB.h 
FUNCTION:  state_format(sc) 

parameter:  STATE_COMP  sc,  defined  in  state.h 
FUNCTION:  state_expand_state_comp{n) 
parameter  int  n,  standard  type 
FUNCTION:  state_expand_derived_com(rc,  n) 
parameter  RADIOlCOMP  rc,  defined  in  state.h 
parameter  int  n,  standard  type 
FUNCTION:  state_clear_dciO 
FUNCTION:  statB_fill_one_radio(rc,  ip,  state_now) 
parameter:  RADIOLCOMP  ic,  defined  in  state.b 
parameter:  RadioInfoP  rp,  defined  in  radmon.h 
parameter  MSEC  state_now,  defined  in  timeline.h 
FUNCTION:  state_format_statistics(dc,  n,  overall_time) 
parameter  DERrVED_COMP  dc,  defined  in  state.h 
parameter  int  n,  standard  type 
parameter  MSEC  overall_time,  defined  in  timeline.h 
FUNCTION:  state_coinpile_statistics(rc,  total_tiroe) 
parameter:  RADIOlCOMP  IC,  defined  in  StatB.h 
parameter  MSEC  total_time,  defined  in  timeline.h 
FUNCTION:  state_radioLCom_comparc(rcl,  rc2) 
parameter  RADIO_COMP  rcl,  defined  in  state.h 
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paiameten  RADIO_COMP  rc2,  defined  in  state.h 
FUNCTION:  state_deiived_coni_conjpaie(dcl,  dc2) 
parameter:  DERIVED_COMP  del,  defined  in  state.h 
parameter:  DERIVED_COMP  dc2,  defined  in  state.h 
FUNCTION:  state_expand_radio_com(n_radios) 
parameter:  int  n_radios,  standard  type 
FUNCTION:  state_display (force) 

parameter:  Boolean  force,  defined  in  radmon.h 
FUNCTION:  state_functionO 
FUNCTION:  state_update() 

FUNCTION:  state_nth(n) 

parameter:  int  n,  standard  type 
FUNCmON:  state_destroy() 
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FILE:  status.c 

FUNCTION:  status_close_callback(w,  rp,  b) 

parameter  Widget  w,  defined  in  <X1 1/Intiinsic.h> 
parameter:  RadioInfoP  ip,  defined  in  radmon.h 
parameter  caddr_t  b,  defined  in  <sys/types.h> 
FUNCTION:  status_select(w,  a,  cback) 

parameter  Widget  w,  defined  in  <X1 1/Intnnsic.h> 
parameter  caddr_t  a,  defined  in  <sysAypes.h> 
parameter  XmButtonLCallbackStruct  *cback 
FUNCTION:  set_widget_labelO 
FUNCTION:  set_status_labelO 
FUNCTION:  stamsRegisterNamesO 
FUNCTION;  statusInitWidgetsO 
FUNCTION:  cieate_status_widgBt(ip) 

parameter  RadioInfoP  rp,  defined  in  radm(m.h 
FUNCTION:  areate_status_select_butftm(ip) 
parameter:  RadioInfoP  rp,  defined  in  radm(m.h 
FUNCTION:  getUpdateFlagsfold.state,  new_state) 

parameter  register  STATEP  old_state,  defined  in  state.h 
parameter  register  STAIEP  new.state,  defined  in  state.h 
FUNCTION:  status_new_radio(rp) 

parameter  RadioInfoP  rp,  defined  in  radm(xi.h 
FUNCTION:  UTMString(x,  y) 

parameter  double  x,  y,  standard  type 
FUNCTION:  unhilite_widget(w) 

parameter  Widget  w,  defined  in  <X1 1/Intrinsic.h> 


130 


BBN  Systems  and  Technologies 


BBN  Report  No.  7628 


FUNCTION:  status_update(rp) 

parametBr:  RadioInfoP  rp,  defined  in  radmon.h 
FUNCTION:  UpdateRadioStatusQ 
FUNCTION:  status.destroyO 
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FILE:  tiineline.c 

FUNCTION:  tlEnqueue(tlq,  tis) 

parameter  register  TLQP  tlq,  defined  in  radnK}n.h 
parameter  register  TLSP  tls,  defined  in  radmon.h 
FUNCTION:  tlDequeue(tlq) 

parameter  register  TLQP  tlq,  defined  in  radmon.h 
FUNCTION:  tiReplenishFieelistO 
FUNCTION:  tllnitO 

FUNCTION:  tlChangeState(rp,  timestan^) 

parameter  RadioInfoP  ip,  defined  in  radmon.h 
parameter  MSEC  dmestamp,  defined  in  timeline.h 
FUNCTION:  tlNext(dsp,  Uep) 

parameter  register  TLSP  '*'tlsp,  defined  in  ladmoah 
parameter  register  TLEP  *tlep,  defined  in  radmon.h 
FUNCTION:  tlPtev(tlsp,  tlep) 

parameter  register  TLSP  "'tlsp,  defined  in  radmoruh 
parameter  register  TLEP  *tlep,  defined  in  radmon.h 
FUNCTION:  tlFind(rp,  when,  tlsp,  ticp) 

parameter:  RadioInfoP  rp,  defined  in  radmon.h 
parameter  long  when,  standard  type 
parameter  TLSP  *tlsp,  defined  in  radmon.h 
parameter  TLEP  *tlep,  defined  in  radmon.h 
FUNCTION:  tlReadFile(f,  rp) 

parameter  FILE  *f,  defined  in  <stdio.h> 
parameter  RadioInfoP  rp,  defined  in  radmon.h 
FUNCTION:  tlCountFiIe(rp) 
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parameter:  RadioInfoP  rp,  defined  in  radmon.h 
FUNCTION:  tlWriteHle(f,  rp) 

parameten  FILE  *f,  defined  in  <stdio.h> 
parameter  RadioInfoP  rp,  defined  in  radmon.h 
FUNCTION:  tlFiee(rp) 

parameter:  RadioInfoP  rp,  defined  in  radmon.h 
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FILE:  trafY1c.c 

FUNCTION:  TIME_TO_WINDOW_COORD(trf,  t) 
parameten  TRAFFIC_INFOP  trf,  defined  in  traffic.h 
parameter.  MSEC  t,  defined  in  timeline.h 
FUNCTION:  WINPOW_TO_TIME_COORD(irf,  X) 
parameter  TRAFFIC_INFOP  trf,  defined  in  traffic.h 
parameten  int  x,  standard  type 
FUNCTION:  TIME_TO_WINDOW_DELTA(tif.  t) 
parameter  TRAFFIC.INFOP  of,  deEned  in  traffic.h 
parameter  MSEC  t,  defined  in  time]ine.h 
FUNCTION:  WINDOW_TO_TIME_DELTA(trf,  x) 
parameter  TRAFFIC_INFOP  trf,  defined  in  traffic.h 
parameter  int  x,  standard  type 
FUNCTION:  trafficRegisterNamesO 
FUNCTION:  trafficInitWidgetsO 
FUNCTION:  traffic_cursor_valid(tif) 

parameter  TRAFFIC_INFOP  trf,  defined  in  traffic.h 
FUNCTION:  traffic_cursor_invalid(trf) 

parameter  TRAFFIC_INFOP  trf,  defined  in  traffic.h 
FUNCTION:  traffic_set_scroIlbar(trf) 

parameter  TRAFFIC_INFOP  trf,  defined  in  traffic.h 
FUNCTION:  traffic_set_cursOT_time(time) 
parameter  MSEC  time,  defined  in  timeline.h 
FUNCTION:  traffic_cursOT_time(p) 

parameto::  MSEC  *p,  defined  in  timeline.h 
FUNCTION:  traffic_draw_cursor(trf) 
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paiameten  TRAFFIC_INFOP  trf,  defined  in  trafiic.h 
FUNCTION:  traffic_erase_cursor(trf) 

parameter:  TRAFFIC_INFOP  trf,  deHned  in  tra£fic.h 
FUNCTION:  traffic_erase_labels(trf,  firstLslot,  last_slot) 
parameter  TRAFFIC_INFOP  trf,  defined  in  traffic.h 
parameter  int  first_slot,  standard  type 
parameter  int  last_slot,  standard  type 
FUNCTION:  trafRc_erase_drawing(irf) 

parameter  TRAFFIC.INFOP  trf,  defined  in  traffic.h 
FUNCTION:  tune_selected(bi,  tune) 

parameter  BUTTON_INFOP  bi,  defined  in  traffic.h 
parameter  TUNEP  tune,  defined  in  tune.h 
FUNCTION:  traffic_draw_label(trf,  slot) 

parameter  TRAFFIC_INFOP  trf,  defined  in  trafiic.h 
parameter  int  slot,  standard  type 
FUNCTION:  traffic_draw_slot(trf,  slot,  left,  width) 
parameter  TRAFFIC.INFOP  trf,  defined  in  trafiic.h 
parameter  int  slot,  standard  type 
parameter  int  left,  standard  type 
parameter  int  width,  standard  type 
FUNCTION:  trafiic_draw_labels(trf,  first_slot,  last_slot) 
parameter  TRAFFIC.INFOP  trf,  defined  in  trafiic.h 
parameter  int  first.slot,  standard  type 
parameter  int  last.slot,  standard  type 
FUNCTION:  trafiic_fonnat_tinie(trf,  time) 

parameter  TRAFFIC_INFOP  trf,  defined  in  trafiic.h 
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parameter  long  dme,  standard  type 
FUNCTION:  traf!ic_fotinat_traffic_tiine(tiine) 
parameter  MSEC  time,  defined  in  timeline.h 
FUNCTION:  trafficjtime_to_date_field(time) 
parameter  long  dme,  standard  type 
FUNCTION:  traffic_measure_grid(tif) 

parameter  TRAFFIC_INFOP  trf,  defined  in  traffic.h 
FUNCTION:  tra£fic_draw_grid(trf,  left,  width) 

parameter  TRAFFIC.INFOP  tif,  defined  in  trafiic.h 
parameter  int  left,  standard  type 
parameter  int  width,  standard  type 
FUNCTION:  traffic_draw_slots(trf,  first_slot,  last_slot,  left,  width) 
parameter  TRAFFICJNFOP  af^  defined  in  naffich 
parameter  int  first_slot,  standard  type 
parameter  int  last_slot,  standard  type 
parameter  int  left,  standard  Qrpe 
parameter  int  width,  standard  type 
FUNCTION:  traffic_redraw_labels(w,  trf,  cback) 
parameter  Widget  w,  defined  in  <X1 1/Intrinsic.h> 
parameter  TRAFFIC_INFOP  trf,  defined  in  traffic.h 
parameter  XmDrawingAreaCallbackStruct  *cback,  defined  in  <Xm/Xm.h> 
FUNCTION:  traffic_redraw(trf,  left,  top,  width,  height) 
parameter  TRAFFIC_INFOP  trf,  defined  in  traffic.h 
paranreter  int  left,  top,  standard  type 
parameter:  int  width,  height,  standard  type 
FUNCTION:  traffic_expose(w,  trf,  cback) 
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parameter  Widget  w,  defined  in  <X1 1/Intiinsic.h> 
parameter  TRAFFIC_INFOP  trf,  defined  in  traffic.h 
parameter  XmDrawingAreaCallbackStruct  *cback,  defined  in  <Xm/Xm.h> 
FUNCTION:  traffic_graphics_expose(w,  trf,  event) 
parameter  Widget  w,  defined  in  <X1 1/Intrinsic.h> 
parameter  TRAFFIC_INFOP  trf,  defined  in  traffic.h 
parameter  XEvent  *event,  defined  in  <X1 1/Xlib.h> 

FUNCTION:  traffic_resize(w,  trf,  cback) 

parameter  Widget  w,  defined  in  <X1 1/Intrinsic.h> 
parameter  TRAFFIC_INFOP  trf,  defined  in  traffic.h 
parameter  XmDrawingAreaCallbackStruct  *cback,  defined  in  <Xm/Xm.h> 
FUNCTION:  traffic_close(w,  trf,  cback) 

parameter  Widget  w,  defined  in  <X1 1/Intrinsic.h> 
parameter  TRAFFIC_INFOP  trf,  defined  in  traffic.h 
parameter  caddr.t  cback,  defined  in  <sys/types.h> 

FUNCTION:  traffic_zoom_in(w,  trf,  cback) 

parameter  Widget  w,  defined  in  <X1 1/Intrinsic.h> 
parameter  TRAFFIC_INFOP  trf,  defined  in  traffic.h 
parameter  caddr.t  cback,  defined  in  <sys/types.h> 

FUNCTION:  ttaffic_zoom_out(w,  trf,  cback) 

parameter  Widget  w,  defined  in  <X1 1/Intrinsic.h> 
parameter  TRAFFIC_INFOP  trf,  defined  in  traffic.h 
parameter  caddr.t  cback,  defined  in  <sysAypes.h> 

FUNCTION:  traffic_left(trf,  delta,  limit) 

parameter  TRAFFIC_INFOP  trf,  defined  in  traffic.h 
parameter  int  delta,  standard  type 
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parameten  int  limit,  standard  type 
FUNCTION;  traffic_continue_pan_lcft(tcf,  id) 

parameter.  TRAFFIC_INFOP  trf,  defined  in  traffic.h 
parameter  Xtlntervalld  id,  defined  in  <X1 1/Intrinsic.h> 
FUNCTION:  traffic_pan_left(w,  trf,  cback) 

parameter  Widget  w,  defined  in  <X1 1/Intrinsic.h> 
parameter  TRAFFIC_INFOP  trf,  defined  in  traffic.h 
parameter  XmAnyCallbackStruct  '"cback,  defined  in  <Xm/Xm.h> 
FUNCTION:  traffic_right(trf,  delta) 

parameter  TRAFFIC_INFOP  trf,  defined  in  traffic.h 
parameter  int  delta,  standard  type 
FUNCTION:  traffic_continue_panjright(trf,  id) 

parameter  TRAFFIC_INFOP  trf,  defined  in  trafiic.h 
parameter  Xtlntervalld  id,  defined  in  <X1 1/Intrinsic.h> 
FUNCTION:  traffic_pan_right(w,  trf,  cback) 

parameter  Widget  w,  defined  in  <XI  1/Intrinsic.h> 
parameter  TRAFFIC_INFOP  trf,  defined  in  traffic.h 
parameter  XmAnyCallbackStruct  '"cback,  defined  in  <Xm/Xm.h> 
FUNCTION:  traffic_fit(w,  trf,  cback) 

parameter  Widget  w,  defined  in  <XI  1/Intrinsic.h> 
parameter  TRAFFIC_INFOP  trf,  defined  in  traffic.h 
parameter:  caddr.t  cback,  defined  in  <sysAypes.h> 

FUNCTION:  traffic_freeze(w,  trf,  cback) 

parameter  Widget  w,  defined  in  <X1  l/lntrinsic.h> 
parameter  TRAFFIC_INFOP  trf,  defined  in  traffic.h 
parameter;  caddr_t  cback,  defined  in  <sys/types.h> 
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FUNCTION:  traffic_unftee2e(w,  trf,  cback) 

parameter  Widget  w,  de&ied  in  <X1 1/Intrinsic.h> 
parameter  TRAFFIC_INFOP  trf,  defined  in  tra£fic.h 
parameter  caddr_t  cback,  defined  in  <sys/types.h> 

FUNCTION:  traffic_input(w,  trf,  cback) 

parameter  Widget  w,  defined  in  <X1 1/Intrinsic.h> 
parameter  TRAFFIC_INFOP  trf,  defined  in  traffic.h 
parameter  XmDrawingAreaCallbackStruct  *cback,  defined  in  <Xm/Xm.h> 
FUNCTION:  traffic_set_offset(trf,  new_offset) 

parameter  TRAFFIC_INFOP  trf,  defined  in  traffic.h 
parameter  int  new_offset,  standard  type 
FUNCTION:  traffic_scrollbar(w,  trf,  cback) 

parameter  Widget  w,  defined  in  <X1 1/Intrinsic.h> 
parameter  TRAFFIC_INFOP  trf,  defined  in  traffic.h 
parameter  XmScroUBarCallbackStruct  ’^cback,  defined  in  <Xm/Xm.h> 
FUNCTION:  traffic_motion(w,  trf,  event) 

parameter  Widget  w,  defined  in  <X11/Intrinsic.h> 
parameter  TRAFFIC_INFOP  trf,  defined  in  traffic.h 
parameter  XEvent  *event,  defined  in  <X1 1/Xlib.h> 

FUNCTION:  traffic_allocate_colors(trf) 

parameter  TRAFFIC_INFOP  trf,  defined  in  traffic.h 
FUNCTION:  traffic_CTcatc_widgct(trf) 

parameter  TRAFFIC_INFOP  trf,  defined  in  traffic.h 
FUNCTION:  traffic_new_height(trO 

parameter  TRAFFIC_INFOP  trf,  defined  in  traffic.h 
FUNCTION:  traffic_add_pos(trf,  position) 
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parameter  TRAFFIC_INFOP  trf,  defined  in  traffic.h 
parameter  int  position,  standard  type 
FUNCTION:  traffic_delete_j>os(tif.  posidon) 

parameter  TRAFFIC_INFOP  trf.  defined  in  traffic.h 
parameter  int  position,  standaid  type 
FUNCTION:  traffic_sub_select(w,  bi,  cback) 

parameter  Widget  w,  defined  in  <X1 1/Intrinsic.h> 
parameter  BUTTON_INFOP  bi,  defined  in  traffic.h 
parameter  XmlistCallbackStruct  ^cback,  defined  in  <Xin/Xm.h> 
FUNCTION:  traffic.createjadio.buttcmftif,  rp) 

parameter  TRAFFIC_INFOP  trf,  defined  in  traffic.h 
parameter  RadioInfoP  ip,  defined  in  radmon.h 
FUNCTION;  £raffic_cieate_tunc_butK»i(trf,  tune) 
parameter  TRAFFIC_INFOP  trf,  defined  in  traffic.h 
parameter  TUNEP  tune,  defined  in  tune.h 
FUNCTION:  traffic_resetO 
FUNCTION:  traffic_new_tune(tune) 

parameter  TUNEP  tune,  defined  in  tune.h 
FUNCTION;  traffic_new_tadio(rp) 

parameter  RadioInfoP  rp,  defined  in  radnx».h 
FUNCTION;  traffic.updateQ 
FUNCTION:  UpdateRadioTrafficO 
FUNCTION;  traffic_destroy() 
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FILE:  tune.c 

FUNCTION:  tune_count_fileO 
FUNCTION:  tune_writc_file(f) 

parameter  FILE  *f,  defined  in  <stdio.h> 
FUNCTION:  tunejcad_file(f,  version) 
parameter  FILE  *f,  defined  in  <stdio.h> 
parameter  int  version,  standard  type 
FUNCTION:  tuneReplenishFreelistO 
FUNCTION:  tuneAllocateQ 
FUNCTION:  tune_init() 

FUNCTION:  tune_set_name(tunel) 

parameter  TUNEP  tunel,  defined  in  tune.h 
FUNCTION:  tune_find(mode,  frequency,  hopinfo) 
parameter  unsigned  char  mode,  standard  type 
parameter  long  firequency,  standard  type 
parameter  FHParameters  '"hopinfo 
FUNCTION:  tune_new() 

FUNCTION:  tune.con^areftl,  t2) 

parameter  register  TUNEP  tl,  defined  in  tune.h 
parameter  register  TUNEP  t2,  defined  in  tune.h 
FUNCTION:  tvme_destroyO 
FUNCTION:  tune_nth(n) 

parameter  int  n,  standard  type 
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FILE:  version.c 

No  Typcdefs  for  this  file. 

FILE:  hT'ihie.h 

No  Typcdefs  for  this  file. 

FILE:  radinon.h 

No  Typcdefs  for  this  file. 

FILE:  state.h 

No  Typcdefs  for  this  file. 

FILE:  style.h 

No  Typcdefs  for  this  file. 

FILE:  tiineline.h 

No  Typcdefs  for  this  file. 

FILE:  traffich 

No  Typedefs  for  this  file. 

FILE:  tune.h 

No  Typcdefs  for  this  file. 


